Google Maps

Use Google Maps 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.

Use the block

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

Actions

Google Maps Air Quality

Get current air quality data for a location

Inputs and outputs

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

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

Get directions and route information between two locations

Inputs and outputs

Input

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

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

Calculate travel distance and time between multiple origins and destinations

Inputs and outputs

Input

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

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

Get elevation data for a location

Inputs and outputs

Input

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

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

Convert an address into geographic coordinates (latitude and longitude)

Inputs and outputs

Input

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

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

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

Inputs and outputs

Input

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

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

Google Maps Place Details

Get detailed information about a specific place

Inputs and outputs

Input

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

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)

Google Maps Places Nearby Search

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

Inputs and outputs

Input

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

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

Google Maps Places Search

Search for places using a text query

Inputs and outputs

Input

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

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 Pollen

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

Inputs and outputs

Input

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

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)

Google Maps Reverse Geocode

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

Inputs and outputs

Input

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

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

Snap GPS coordinates to the nearest road segment

Inputs and outputs

Input

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

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 Solar

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

Inputs and outputs

Input

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

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

Google Maps Speed Limits

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

Inputs and outputs

Input

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

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

Get timezone information for a location

Inputs and outputs

Input

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

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

Validate and standardize a postal address

Inputs and outputs

Input

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

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