# Google Maps Platform MCP

> Google Maps Platform provides instant, authoritative location intelligence for any AI agent. Use this MCP to convert addresses into precise coordinates, calculate complex driving or walking routes, and find detailed information on businesses globally. It handles everything from getting the elevation at a coordinate point to calculating how long it takes to drive between multiple stops.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** geocoding, location-intelligence, routing, place-details, spatial-data

## Description

Need to know exactly where something is, or how to get there? This MCP connects your AI client directly to Google’s global mapping data, giving you instant access to location intelligence. You can turn a street address into precise GPS coordinates using geocoding, or take those coordinates and figure out what physical address they belong to via reverse geocoding. Planning a multi-stop trip? Calculate the total distance and time required between origins and destinations with one call. It even finds nearby points of interest—like gas stations or restaurants—around any specific coordinate. All this deep location data, which typically requires multiple specialized APIs, is managed under one umbrella through Vinkius. You just connect your preferred AI client, and the agent handles all the complex mapping logic for you.

## Tools

### get_directions
Calculates multi-mode routes, providing step-by-step instructions between two specified points.

### get_distance_matrix
Compares the travel time and distance for multiple starting locations to multiple ending locations simultaneously.

### get_elevation
Retrieves the altitude data for specific coordinates on Earth's surface.

### find_place_from_text
Locates a place and provides its unique ID, which is necessary before retrieving detailed information about it.

### geocode_address
Converts a readable physical address into precise GPS coordinates (latitude/longitude) and returns the formatted location name.

### search_nearby_places
Finds businesses or points of interest, allowing filtering by category or keyword near specific coordinates.

### get_place_details
Pulls detailed information about a single location using its unique Place ID, including reviews and operating hours.

### reverse_geocode
Takes raw GPS coordinates and translates them back into a readable physical street address.

### get_timezone
Determines the correct time zone for any given set of geographic coordinates, essential for scheduling.

## Prompt Examples

**Prompt:** 
```
Find the address for 'Statue of Liberty'.
```

**Response:** 
```
Statue of Liberty is located at Liberty Island, New York, NY 10004. Coordinates: 40.6892° N, 74.0445° W.
```

**Prompt:** 
```
Get directions from Times Square to Central Park.
```

**Response:** 
```
Driving route: Distance: 2.5 miles, Duration: 12 mins. Walk route: Distance: 2.1 miles, Duration: 40 mins.
```

**Prompt:** 
```
Find coffee shops near 'Pike Place Market'.
```

**Response:** 
```
Found 5 nearby: 1. Starbucks Reserve Roastery (4.8⭐). 2. Storyville Coffee (4.7⭐). 3. Cafe Campagne (4.5⭐).
```

## Capabilities

### Calculate Travel Routes
Determine driving, walking, cycling, or transit paths between two or more points.

### Pinpoint Coordinates from Addresses
Convert any physical street address into exact latitude and longitude coordinates.

### Get Business Details
Fetch specific, rich information for a known business location, including hours or phone numbers.

### Analyze Multiple Stops
Compare the travel time and distance between several separate origins and destinations at once.

### Identify Local Amenities
Search for specific types of businesses or points of interest near a given location.

### Determine Time Zones
Pull the correct time zone information required when scheduling events across different regions.

## Use Cases

### Optimizing Delivery Routes
A fulfillment center manager needs to calculate the fastest route for 12 packages going to different zip codes. They ask their agent: 'What is the total time and distance if I start at the warehouse, hitting these 12 addresses?' The agent uses get_distance_matrix, instantly providing a measurable plan that saves hours of manual spreadsheet calculation.

### Verifying Client Addresses
A sales team member gets an address from a prospect and needs to confirm it's real and find the exact coordinates. They run 'What are the GPS coordinates for 123 Main Street?' The agent uses geocode_address, immediately validating the location and giving them the necessary data points.

### Scheduling Global Meetings
An event organizer is coordinating a panel with speakers in London, Tokyo, and New York. They ask: 'What time zone should I list for all three locations?' The agent uses get_timezone, providing accurate temporal data so the meeting invite makes sense globally.

### Building Point-of-Interest Maps
A developer is building a local guide app and needs to populate it with nearby services. They ask: 'Show me all highly-rated Italian restaurants near these coordinates.' The agent uses search_nearby_places, delivering a filtered list of relevant businesses.

## Benefits

- Get precise location data instantly. Instead of manually calling separate services for address lookups, use geocode_address to reliably convert any street address into usable GPS coordinates.
- Plan complex itineraries easily. Calculate travel metrics between multiple stops at once using get_distance_matrix, saving you from writing complex loop logic in your agent code.
- Determine the exact location and details of a business. After finding a place with find_place_from_text, use get_place_details to pull rich data like hours or phone numbers.
- Build robust time-sensitive systems. Use get_timezone to ensure that any scheduling logic your agent runs respects local time differences across the globe.
- Understand location context deeply. Need to know if a GPS coordinate is in Manhattan or rural upstate NY? reverse_geocode converts raw points back into clear, readable addresses.

## How It Works

The bottom line is you give the AI what it needs, and it delivers validated location facts without manual API calls or complex code writing.

1. First, subscribe to this MCP and enter your specific Google Maps API Key into Vinkius.
2. Second, prompt your AI client with the necessary location information (like two addresses or a starting point).
3. Third, the agent uses the available tools to process the request and returns precise data—be it coordinates, directions, or business details.

## Frequently Asked Questions

**How do I find coordinates using Google Maps Platform MCP?**
You use geocode_address. You simply provide a physical address string, and the tool returns the precise latitude/longitude coordinates along with a formatted street name.

**Can get_distance_matrix handle multiple stops?**
Yes, that's what it's for. It accepts origins and destinations separated by pipes (or lists them) to calculate travel time and distance across many locations at once.

**What if I only have GPS coordinates but need a street address?**
You run the reverse_geocode tool. This converts raw latitude/longitude data back into a human-readable, physical address string.

**Do I need a Place ID to get business hours?**
Yes, generally you do. You can use find_place_from_text first to locate the place and obtain the necessary unique Place ID before calling get_place_details.

**How does Google Maps Platform MCP help with time zones?**
You run get_timezone, passing in coordinates. It immediately tells your agent what time zone is active at that exact point on the map, which is critical for scheduling.