# Google Maps (/integrations/google_maps)





{/* MANUAL-CONTENT-START:intro */}

Use [Google Maps](https://maps.google.com) APIs to look up coordinates and places, calculate routes and travel times, validate addresses, and retrieve location-based environmental data. Each action below documents its required location inputs and returned fields.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Look up coordinates and places, calculate routes and travel times, retrieve place, elevation, and timezone details, validate addresses, and query supported environmental data.

## Actions [#actions]

### Google Maps Air Quality [#google-maps-air-quality]

Get current air quality data for a location

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Air Quality API enabled |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |
  | `languageCode` | string | No | Language code for the response (e.g., "en", "es") |

  #### Output [#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 |
</ReferenceDetails>

### Google Maps Directions [#google-maps-directions]

Get directions and route information between two locations

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `origin` | string | Yes | Starting location (address or lat,lng) |
  | `destination` | string | Yes | Destination location (address or lat,lng) |
  | `mode` | string | No | Travel mode: driving, walking, bicycling, or transit |
  | `avoid` | string | No | Features to avoid: tolls, highways, or ferries |
  | `waypoints` | json | No | Array of intermediate waypoints |
  | `units` | string | No | Unit system: metric or imperial |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |

  #### Output [#output-1]

  | 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 |
</ReferenceDetails>

### Google Maps Distance Matrix [#google-maps-distance-matrix]

Calculate travel distance and time between multiple origins and destinations

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `origin` | string | Yes | Origin location (address or lat,lng) |
  | `destinations` | json | Yes | Array of destination locations |
  | `mode` | string | No | Travel mode: driving, walking, bicycling, or transit |
  | `avoid` | string | No | Features to avoid: tolls, highways, or ferries |
  | `units` | string | No | Unit system: metric or imperial |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |

  #### Output [#output-2]

  | 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) |
</ReferenceDetails>

### Google Maps Elevation [#google-maps-elevation]

Get elevation data for a location

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |

  #### Output [#output-3]

  | 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 |
</ReferenceDetails>

### Google Maps Geocode [#google-maps-geocode]

Convert an address into geographic coordinates (latitude and longitude)

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `address` | string | Yes | The address to geocode |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |
  | `region` | string | No | Region bias as a ccTLD code (e.g., us, uk) |

  #### Output [#output-4]

  | 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.) |
</ReferenceDetails>

### Google Maps Geolocate [#google-maps-geolocate]

Geolocate a device using WiFi access points, cell towers, or IP address

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Geolocation API enabled |
  | `homeMobileCountryCode` | number | No | Home mobile country code (MCC) |
  | `homeMobileNetworkCode` | number | No | Home mobile network code (MNC) |
  | `radioType` | string | No | Radio type: lte, gsm, cdma, wcdma, or nr |
  | `carrier` | string | No | Carrier name |
  | `considerIp` | boolean | No | Whether to use IP address for geolocation (default: true) |
  | `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. |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `lat` | number | Latitude coordinate |
  | `lng` | number | Longitude coordinate |
  | `accuracy` | number | Accuracy radius in meters |
</ReferenceDetails>

### Google Maps Place Details [#google-maps-place-details]

Get detailed information about a specific place

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `placeId` | string | Yes | Google Place ID |
  | `fields` | string | No | Comma-separated list of fields to return |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `placeId` | string | Google Place ID |
  | `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) |
</ReferenceDetails>

### Google Maps Places Nearby Search [#google-maps-places-nearby-search]

Search for places of a given type within a radius of a location

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `lat` | number | Yes | Latitude of the center point to search around |
  | `lng` | number | Yes | Longitude of the center point to search around |
  | `radius` | number | Yes | Search radius in meters (up to 50000) |
  | `includedTypes` | array | No | Place types to include in the results (e.g., restaurant, cafe) |
  | `maxResultCount` | number | No | Maximum number of results to return (1-20, defaults to 20) |
  | `rankPreference` | string | No | How to rank results: POPULARITY (default) or DISTANCE |
  | `languageCode` | string | No | Language code for the response (e.g., en, es) |
  | `regionCode` | string | No | Region bias as a ccTLD code (e.g., us, uk) |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `places` | array | List of places found near the given location |
  | ↳ `placeId` | string | Google Place resource 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` | string | Price level (e.g., PRICE\_LEVEL\_MODERATE) |
  | ↳ `openNow` | boolean | Whether currently open |
  | ↳ `businessStatus` | string | Business status |
</ReferenceDetails>

### Google Maps Places Search [#google-maps-places-search]

Search for places using a text query

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `query` | string | Yes | Search query (e.g., "restaurants in Times Square") |
  | `location` | json | No | Location to bias results towards (\{lat, lng}) |
  | `radius` | number | No | Search radius in meters |
  | `type` | string | No | Place type filter (e.g., restaurant, cafe, hotel) |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |
  | `region` | string | No | Region bias as a ccTLD code (e.g., us, uk) |
  | `pageToken` | string | No | Token from a previous search response to fetch the next page of results. Wait a couple seconds after receiving the token before using it, or the API returns INVALID\_REQUEST |

  #### Output [#output-8]

  | 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 |
</ReferenceDetails>

### Google Maps Pollen [#google-maps-pollen]

Get a daily pollen forecast (grass, tree, weed) for a location

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Pollen API enabled |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |
  | `days` | number | No | Number of forecast days to return (1-5, defaults to 1) |
  | `languageCode` | string | No | Language code for the response (e.g., "en", "es") |
  | `plantsDescription` | boolean | No | Include detailed plant descriptions (defaults to true) |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `regionCode` | string | Region code (ISO 3166-1 alpha-2) for the location |
  | `dailyInfo` | array | Daily pollen forecast entries |
  | ↳ `date` | object | Calendar date of the forecast entry |
  | ↳ `pollenTypeInfo` | array | Pollen type indices (grass, tree, weed) |
  | ↳ `code` | string | Pollen type code (GRASS, TREE, WEED) |
  | ↳ `displayName` | string | Display name |
  | ↳ `inSeason` | boolean | Whether the pollen type is in season |
  | ↳ `indexInfo` | object | Universal Pollen Index (UPI) info |
  | ↳ `healthRecommendations` | array | Health recommendations |
  | ↳ `plantInfo` | array | Per-plant forecast with descriptions |
  | ↳ `code` | string | Plant code (e.g., BIRCH, RAGWEED) |
  | ↳ `displayName` | string | Display name |
  | ↳ `inSeason` | boolean | Whether the plant is in season |
  | ↳ `indexInfo` | object | Universal Pollen Index (UPI) info |
  | ↳ `plantDescription` | object | Plant details (type, family, season, cross-reactions) |
</ReferenceDetails>

### Google Maps Reverse Geocode [#google-maps-reverse-geocode]

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

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |
  | `language` | string | No | Language code for results (e.g., en, es, fr) |

  #### Output [#output-10]

  | 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) |
</ReferenceDetails>

### Google Maps Snap to Roads [#google-maps-snap-to-roads]

Snap GPS coordinates to the nearest road segment

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Roads API enabled |
  | `path` | string | Yes | Pipe-separated list of lat,lng coordinates (e.g., "60.170880,24.942795\|60.170879,24.942796") |
  | `interpolate` | boolean | No | Whether to interpolate additional points along the road |

  #### Output [#output-11]

  | 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) |
</ReferenceDetails>

### Google Maps Solar [#google-maps-solar]

Get solar potential and panel insights for the building nearest a location

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Solar API enabled |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |
  | `requiredQuality` | string | No | Minimum imagery quality to accept (HIGH, MEDIUM, or BASE) |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `name` | string | Resource name of the building (e.g., "buildings/ChIJ...") |
  | `center` | object | Center coordinate of the building |
  | ↳ `lat` | number | Latitude |
  | ↳ `lng` | number | Longitude |
  | `imageryDate` | object | Date the underlying imagery was captured |
  | `imageryQuality` | string | Quality of the imagery used (HIGH, MEDIUM, BASE) |
  | `regionCode` | string | Region code (ISO 3166-1 alpha-2) for the building |
  | `postalCode` | string | Postal code of the building |
  | `administrativeArea` | string | Administrative area (e.g., state or province) |
  | `solarPotential` | object | Solar potential: max panel count/area, sunshine hours, carbon offset, panel specs, and configs |
</ReferenceDetails>

### Google Maps Speed Limits [#google-maps-speed-limits]

Get speed limits for road segments. Requires either path coordinates or placeIds.

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Roads API enabled |
  | `path` | string | No | Pipe-separated list of lat,lng coordinates (required if placeIds not provided) |
  | `placeIds` | array | No | Array of Place IDs for road segments (required if path not provided) |
  | `units` | string | No | Units for the returned speed limits: KPH (default) or MPH |

  #### Output [#output-13]

  | 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 |
</ReferenceDetails>

### Google Maps Timezone [#google-maps-timezone]

Get timezone information for a location

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key |
  | `lat` | number | Yes | Latitude coordinate |
  | `lng` | number | Yes | Longitude coordinate |
  | `timestamp` | number | No | Unix timestamp to determine DST offset (defaults to current time) |
  | `language` | string | No | Language code for timezone name (e.g., en, es, fr) |

  #### Output [#output-14]

  | 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) |
</ReferenceDetails>

### Google Maps Validate Address [#google-maps-validate-address]

Validate and standardize a postal address

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Google Maps API key with Address Validation API enabled |
  | `address` | string | Yes | The address to validate (as a single string) |
  | `regionCode` | string | No | ISO 3166-1 alpha-2 country code (e.g., "US", "CA") |
  | `locality` | string | No | City or locality name |
  | `enableUspsCass` | boolean | No | Enable USPS CASS validation for US addresses |

  #### Output [#output-15]

  | 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 |
</ReferenceDetails>