react-google-maps

Integrate Google Maps JavaScript API in React apps with components and hooks.

5|2|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/horuz-ai/claude-plugins --skill react-google-maps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: react-google-maps
Source: https://github.com/horuz-ai/claude-plugins/tree/main/plugins/google/skills/react-google-maps
Command: npx skills add https://github.com/horuz-ai/claude-plugins --skill react-google-maps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive React integration with the Google Maps JavaScript API via @vis.gl/react-google-maps, offering Map, AdvancedMarker, Pin, InfoWindow, MapControl, and related hooks and patterns for building rich mapping experiences.

Core Features & Use Cases

  • APIProvider wrapper to load the Maps API
  • Map, AdvancedMarker, Pin, InfoWindow, MapControl components
  • Hooks: useMap, useMapsLibrary, useAdvancedMarkerRef, useApiIsLoaded, etc.
  • Advanced patterns: controlled vs. uncontrolled maps, real-time drag synchronization, multi-shape coordination

Quick Start

Wrap your app with APIProvider (including your Google Maps API key), render a Map, and optionally add an AdvancedMarker with an InfoWindow.

Frequently Asked Questions about react-google-maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Google Maps into a React app?

Integrate Google Maps by wrapping your app with APIProvider (with your API key), then render a Map component with AdvancedMarker and InfoWindow for interactive mapping. This Skill provides hooks like useMap and useAdvancedMarkerRef for robust composition across client and server-rendered React/Next.js setups.

Can I use draggable markers and real-time synchronization with Google Maps in React?

Yes. This Skill supports draggable AdvancedMarkers with real-time drag synchronization and multi-shape coordination. Use useAdvancedMarkerRef to track marker state and sync positions between markers and shapes as users interact with the map.

How do I add autocomplete and geocoding to a React map application?

Implement Places autocomplete using AutocompleteService with a custom UI (standard Autocomplete was deprecated in March 2025). This Skill provides geocoding utilities and hooks to integrate address lookups and coordinate conversion within your mapping workflow.

What's required to set up AdvancedMarker in Google Maps React integration?

AdvancedMarker requires a mapId to be set on your Map component. All map components must be wrapped with APIProvider at the app root. This Skill exports TypeScript types and hooks to ensure proper setup and composition.

Does this work with Next.js server and client components?

Yes. This Skill accommodates both client and server-rendered setups in modern React ecosystems, including Next.js. Use APIProvider at the app root and leverage hooks like useMap and useApiIsLoaded for proper initialization across rendering modes.

Why aren't Circle and Polygon exported directly as components?

Circle and Polygon are not exported directly; instead, use MapControl and related utilities to handle geometry and drawing. This design accommodates the advanced patterns this Skill provides for real-time shape coordination and multi-component synchronization.

Related Skills