nextjs-google-maps

Integrate Google Maps into Next.js App Router apps with @react-google-maps/api.

1|1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/fumiya-kume/toy-poodle-love --skill nextjs-google-maps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nextjs-google-maps
Source: https://github.com/fumiya-kume/toy-poodle-love/tree/main/.claude/skills/nextjs-google-maps
Command: npx skills add https://github.com/fumiya-kume/toy-poodle-love --skill nextjs-google-maps

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a comprehensive, code-focused guide to integrating Google Maps into a Next.js App Router project, handling client/server concerns, API key management, and best practices for building map-enabled experiences.

Core Features & Use Cases

  • Setup and configuration guidance for Next.js App Router with Google Maps via the @react-google-maps/api library.
  • Coverage of common map tasks: rendering maps, Places autocomplete, directions, geocoding, heatmaps, Street View, and drawing tools.
  • Practical examples and patterns for building map-enabled user experiences in web apps.

Quick Start

Run the Quick Start instructions to configure API keys, install dependencies, and launch the development server for your Next.js app.

Frequently Asked Questions about nextjs-google-maps

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

FAQPage Schema
How do I integrate Google Maps into a Next.js App Router project?

Integrate Google Maps in Next.js by configuring environment variables for API keys, installing the @react-google-maps/api dependency, and applying SSR safety patterns to render interactive maps within the App Router.

Can I use Google Maps Places autocomplete and directions with Next.js?

Yes, you can implement Places autocomplete, route directions, geocoding, heatmaps, and Street View in Next.js by applying the component patterns and client-side examples provided for the @react-google-maps/api library.

What's the best way to handle Google Maps API keys in Next.js?

Handle Google Maps API keys in Next.js by configuring environment variables, ensuring proper API key management, and applying server-side rendering safety patterns to prevent exposure during client/server data fetching.

Why does Google Maps fail to render during Next.js server-side rendering?

Google Maps fails during Next.js server-side rendering because the API requires browser-only access, which requires implementing SSR safety patterns and client/server boundary handling using the @react-google-maps/api library.

Do I need the @react-google-maps/api library to build interactive maps in Next.js?

Yes, using the @react-google-maps/api library provides the necessary React components, SSR safety patterns, and client/server boundary handling required to seamlessly render interactive Google Maps features in Next.js.

Are there limitations when using Google Maps heatmaps and Street View in Next.js?

Limitations when using Google Maps heatmaps and Street View in Next.js involve managing client/server boundaries, as these interactive visualizations require strict client-side rendering patterns to avoid server-side rendering conflicts.