πŸ—ΊοΈ

maps

Open Source LocationResearch

Comprehensive geocoding, places search, directions, and more

google-maps geocoding places directions maps

Quick Install

npm install @openpets/maps
pnpm add @openpets/maps

Available Tools (1)

These tools are available when you install the maps plugin in your AI assistant.

maps-provider-info

Get information about which maps provider is currently being used

Supported Providers

This plugin integrates with the following services. Configure your preferred provider.

Google Maps

Priority 1

Google Maps API for geocoding, directions, and places

GOOGLE_MAPS_API_KEY

Mapbox

Priority 2

Mapbox API for geocoding, directions, and places

MAPBOX_API_KEY

OpenStreetMap

Priority 3

OpenStreetMap API for geocoding, directions, and places

OSM_EMAIL

Example Queries

find the coordinates of Times Square, New York
search for restaurants near Central Park, New York

Usage Scenarios

geocoding workflow

  1. 1 find the coordinates of Times Square, New York
  2. 2 now get the timezone for those coordinates
  3. 3 check if street view is available There

planning trip

  1. 1 find the coordinates of Eiffel Tower, Paris
  2. 2 search for restaurants within 500 meters of those coordinates
  3. 3 get directions from Eiffel Tower to the first restaurant

multi city route

  1. 1 get directions from Times Square to Central Park
  2. 2 now get walking directions for the same route
  3. 3 calculate the distance between New York and Boston

Optional Configuration

Variable Description
MAPS_DEFAULT_LOCATION Default location for 'near me' searches (e.g., 'New York, NY' or '40.7580,-73.9855')

Use maps with Your AI Assistant

This open source plugin works with OpenCode-compatible AI assistants including ChatGPT, Claude, Perplexity, and other LLM-powered coding tools. Install the plugin and start using natural language to interact with Google Maps, Mapbox, OpenStreetMap.

Works with ChatGPT Works with Claude Works with Perplexity MCP Compatible