Google Maps

Usage Instructions

Integrate Google Maps Platform APIs into your workflow. Supports geocoding addresses to coordinates, reverse geocoding, getting directions between locations, calculating distance matrices, searching for places, retrieving place details, elevation data, and timezone information.

Tools

`google_maps_air_quality`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`lat`	number	Yes	No description
`lng`	number	Yes	No description
`languageCode`	string	No	Language code for the response (e.g., "en", "es")
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`dateTime`	string	Timestamp of the air quality data
`regionCode`	string	Region code for the location
`indexes`	array	Array of air quality indexes
↳ `code`	string	Index code (e.g., "uaqi", "usa_epa")
↳ `displayName`	string	Display name of the index
↳ `aqi`	number	Air quality index value
↳ `aqiDisplay`	string	Formatted AQI display string
↳ `color`	object	RGB color for the AQI level
↳ `category`	string	Category description (e.g., "Good", "Moderate")
↳ `dominantPollutant`	string	The dominant pollutant
`pollutants`	array	Array of pollutant concentrations
↳ `code`	string	Pollutant code (e.g., "pm25", "o3")
↳ `displayName`	string	Display name
↳ `fullName`	string	Full pollutant name
↳ `concentration`	object	Concentration info
↳ `value`	number	Concentration value
↳ `units`	string	Units (e.g., "PARTS_PER_BILLION")
↳ `additionalInfo`	object	Additional info about sources and effects
`healthRecommendations`	object	Health recommendations for different populations

`google_maps_directions`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`origin`	string	Yes	No description
`destination`	string	Yes	No description
`mode`	string	No	No description
`avoid`	string	No	No description
`waypoints`	json	No	No description
`units`	string	No	No description
`language`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`routes`	array	All available routes
↳ `summary`	string	Route summary (main road names)
↳ `legs`	array	Route legs (segments between waypoints)
↳ `overviewPolyline`	string	Encoded polyline for the entire route
↳ `warnings`	array	Route warnings
↳ `waypointOrder`	array	Optimized waypoint order (if requested)
`distanceText`	string	Total distance as human-readable text (e.g., "5.2 km")
`distanceMeters`	number	Total distance in meters
`durationText`	string	Total duration as human-readable text (e.g., "15 mins")
`durationSeconds`	number	Total duration in seconds
`startAddress`	string	Resolved starting address
`endAddress`	string	Resolved ending address
`steps`	array	Turn-by-turn navigation instructions
↳ `instruction`	string	Navigation instruction (HTML stripped)
↳ `distanceText`	string	Step distance as text
↳ `distanceMeters`	number	Step distance in meters
↳ `durationText`	string	Step duration as text
↳ `durationSeconds`	number	Step duration in seconds
↳ `startLocation`	object	Step start coordinates
↳ `endLocation`	object	Step end coordinates
↳ `travelMode`	string	Travel mode for this step
↳ `maneuver`	string	Maneuver type (turn-left, etc.)
`polyline`	string	Encoded polyline for the primary route

`google_maps_distance_matrix`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`origin`	string	Yes	No description
`destinations`	json	Yes	No description
`mode`	string	No	No description
`avoid`	string	No	No description
`units`	string	No	No description
`language`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`originAddresses`	array	Resolved origin addresses
`destinationAddresses`	array	Resolved destination addresses
`rows`	array	Distance matrix rows (one per origin)
↳ `elements`	array	Elements (one per destination)
↳ `distanceText`	string	Distance as text (e.g., "5.2 km")
↳ `distanceMeters`	number	Distance in meters
↳ `durationText`	string	Duration as text (e.g., "15 mins")
↳ `durationSeconds`	number	Duration in seconds
↳ `durationInTrafficText`	string	Duration in traffic as text
↳ `durationInTrafficSeconds`	number	Duration in traffic in seconds
↳ `status`	string	Element status (OK, NOT_FOUND, ZERO_RESULTS)

`google_maps_elevation`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`lat`	number	Yes	No description
`lng`	number	Yes	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`elevation`	number	Elevation in meters above sea level (negative for below)
`lat`	number	Latitude of the elevation sample
`lng`	number	Longitude of the elevation sample
`resolution`	number	Maximum distance between data points (meters) from which elevation was interpolated

`google_maps_geocode`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`address`	string	Yes	No description
`language`	string	No	No description
`region`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`formattedAddress`	string	The formatted address string
`lat`	number	Latitude coordinate
`lng`	number	Longitude coordinate
`location`	json	Location object with lat and lng
`placeId`	string	Google Place ID for this location
`addressComponents`	array	Detailed address components
↳ `longName`	string	Full name of the component
↳ `shortName`	string	Abbreviated name
↳ `types`	array	Component types
`locationType`	string	Location accuracy type (ROOFTOP, RANGE_INTERPOLATED, etc.)

`google_maps_geolocate`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`homeMobileCountryCode`	number	No	No description
`homeMobileNetworkCode`	number	No	No description
`radioType`	string	No	No description
`carrier`	string	No	No description
`considerIp`	boolean	No	No description
`cellTowers`	array	No	Array of cell tower objects with cellId, locationAreaCode, mobileCountryCode, mobileNetworkCode
`wifiAccessPoints`	array	No	Array of WiFi access point objects with macAddress (required), signalStrength, etc.
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`lat`	number	Latitude coordinate
`lng`	number	Longitude coordinate
`accuracy`	number	Accuracy radius in meters

`google_maps_place_details`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`placeId`	string	Yes	No description
`fields`	string	No	No description
`language`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`placeId`	string	placeId output from the tool
`name`	string	Place name
`formattedAddress`	string	Formatted street address
`lat`	number	Latitude coordinate
`lng`	number	Longitude coordinate
`types`	array	Place types (e.g., restaurant, cafe)
`rating`	number	Average rating (1.0 to 5.0)
`userRatingsTotal`	number	Total number of user ratings
`priceLevel`	number	Price level (0=Free, 1=Inexpensive, 2=Moderate, 3=Expensive, 4=Very Expensive)
`website`	string	Place website URL
`phoneNumber`	string	Local formatted phone number
`internationalPhoneNumber`	string	International formatted phone number
`openNow`	boolean	Whether the place is currently open
`weekdayText`	array	Opening hours formatted by day of week
`reviews`	array	User reviews (up to 5 most relevant)
↳ `authorName`	string	Reviewer name
↳ `authorUrl`	string	Reviewer profile URL
↳ `profilePhotoUrl`	string	Reviewer photo URL
↳ `rating`	number	Rating given (1-5)
↳ `text`	string	Review text
↳ `time`	number	Review timestamp (Unix epoch)
↳ `relativeTimeDescription`	string	Relative time (e.g., "a month ago")
`photos`	array	Place photos
↳ `photoReference`	string	Photo reference for Place Photos API
↳ `height`	number	Photo height in pixels
↳ `width`	number	Photo width in pixels
↳ `htmlAttributions`	array	Required attributions
`url`	string	Google Maps URL for the place
`utcOffset`	number	UTC offset in minutes
`vicinity`	string	Simplified address (neighborhood/street)
`businessStatus`	string	Business status (OPERATIONAL, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY)

`google_maps_places_search`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`query`	string	Yes	Search query (e.g., "restaurants in Times Square")
`location`	json	No	No description
`radius`	number	No	No description
`type`	string	No	No description
`language`	string	No	No description
`region`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`places`	array	List of places found
↳ `placeId`	string	Google Place ID
↳ `name`	string	Place name
↳ `formattedAddress`	string	Formatted address
↳ `lat`	number	Latitude
↳ `lng`	number	Longitude
↳ `types`	array	Place types
↳ `rating`	number	Average rating (1-5)
↳ `userRatingsTotal`	number	Number of ratings
↳ `priceLevel`	number	Price level (0-4)
↳ `openNow`	boolean	Whether currently open
↳ `photoReference`	string	Photo reference for Photos API
↳ `businessStatus`	string	Business status
`nextPageToken`	string	Token for fetching the next page of results

`google_maps_reverse_geocode`

Convert geographic coordinates (latitude and longitude) into a human-readable address

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`lat`	number	Yes	No description
`lng`	number	Yes	No description
`language`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`formattedAddress`	string	The formatted address string
`placeId`	string	Google Place ID for this location
`addressComponents`	array	Detailed address components
↳ `longName`	string	Full name of the component
↳ `shortName`	string	Abbreviated name
↳ `types`	array	Component types
`types`	array	Address types (e.g., street_address, route)

`google_maps_snap_to_roads`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`path`	string	Yes	Pipe-separated list of lat,lng coordinates (e.g., "60.170880,24.942795\|60.170879,24.942796")
`interpolate`	boolean	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`snappedPoints`	array	Array of snapped points on roads
↳ `location`	object	Snapped location coordinates
↳ `lat`	number	Latitude
↳ `lng`	number	Longitude
↳ `originalIndex`	number	Index in the original path (if not interpolated)
↳ `placeId`	string	Place ID for this road segment
`warningMessage`	string	Warning message if any (e.g., if points could not be snapped)

`google_maps_speed_limits`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`path`	string	No	No description
`placeIds`	array	No	No description

Output

Parameter	Type	Description
`speedLimits`	array	Array of speed limits for road segments
↳ `placeId`	string	Place ID for the road segment
↳ `speedLimit`	number	Speed limit value
↳ `units`	string	Speed limit units (KPH or MPH)
`snappedPoints`	array	Array of snapped points corresponding to the speed limits
↳ `location`	object	Snapped location coordinates
↳ `lat`	number	Latitude
↳ `lng`	number	Longitude
↳ `originalIndex`	number	Index in the original path
↳ `placeId`	string	Place ID for this road segment

`google_maps_timezone`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`lat`	number	Yes	No description
`lng`	number	Yes	No description
`timestamp`	number	No	No description
`language`	string	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`timeZoneId`	string	IANA timezone ID (e.g., "America/New_York", "Europe/London")
`timeZoneName`	string	Localized timezone name (e.g., "Eastern Daylight Time")
`rawOffset`	number	UTC offset in seconds (without DST)
`dstOffset`	number	Daylight Saving Time offset in seconds (0 if not in DST)
`totalOffsetSeconds`	number	Total UTC offset in seconds (rawOffset + dstOffset)
`totalOffsetHours`	number	Total UTC offset in hours (e.g., -5 for EST, -4 for EDT)

`google_maps_validate_address`

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	No description
`address`	string	Yes	No description
`regionCode`	string	No	ISO 3166-1 alpha-2 country code (e.g., "US", "CA")
`locality`	string	No	No description
`enableUspsCass`	boolean	No	No description
`pricing`	per_request	No	No description
`rateLimit`	string	No	No description

Output

Parameter	Type	Description
`formattedAddress`	string	The standardized formatted address
`lat`	number	Latitude coordinate
`lng`	number	Longitude coordinate
`placeId`	string	Google Place ID for this address
`addressComplete`	boolean	Whether the address is complete and deliverable
`hasUnconfirmedComponents`	boolean	Whether some address components could not be confirmed
`hasInferredComponents`	boolean	Whether some components were inferred (not in input)
`hasReplacedComponents`	boolean	Whether some components were replaced with canonical values
`validationGranularity`	string	Granularity of validation (PREMISE, SUB_PREMISE, ROUTE, etc.)
`geocodeGranularity`	string	Granularity of the geocode result
`addressComponents`	array	Detailed address components
↳ `longName`	string	Full name of the component
↳ `shortName`	string	Abbreviated name
↳ `types`	array	Component types
`missingComponentTypes`	array	Types of address components that are missing
`unconfirmedComponentTypes`	array	Types of components that could not be confirmed
`unresolvedTokens`	array	Input tokens that could not be resolved

Google Maps

On this page