Location Street View & Satellite Imagery
Geocode addresses, reverse-geocode coordinates, and retrieve Street View and satellite/aerial images for any location worldwide.
Actions
geocode
Convert a street address or place name into geographic coordinates.
Required fields:
action–"geocode"address(string) – Street address or place name to geocode
Response includes: formatted_address, location (lat/lng), place_id, address_components
Example:
{
"action": "geocode",
"address": "1600 Amphitheatre Parkway, Mountain View, CA"
}
reverse_geocode
Convert latitude/longitude coordinates into a human-readable address.
Required fields:
action–"reverse_geocode"latitude(number) – Latitude, -90 to 90longitude(number) – Longitude, -180 to 180
Response includes: formatted_address, place_id, address_components
Example:
{
"action": "reverse_geocode",
"latitude": 37.4219999,
"longitude": -122.0840575
}
get_street_view_image
Retrieve a Street View photograph for a location. Provide either an address or latitude/longitude coordinates.
Required fields:
action–"get_street_view_image"address(string) orlatitude+longitude(numbers) – The location to photograph
Optional fields:
heading(integer, 0-360) – Camera compass heading in degrees. Omit to let the API choose automatically.pitch(integer, -90 to 90) – Camera vertical angle. Default: 0 (level). Negative values look down, positive look up.fov(integer, 1-120) – Field of view in degrees. Default: 90. Lower values zoom in.image_width(integer, max 640) – Image width in pixels. Default: 640.image_height(integer, max 640) – Image height in pixels. Default: 640.
Response includes: signed_url (image link to present to user), image_base64, file_id, size_bytes, pano_id, image_date, available (boolean)
Example – by address with camera settings:
{
"action": "get_street_view_image",
"address": "1600 Amphitheatre Parkway, Mountain View, CA",
"heading": 210,
"pitch": 10
}
Example – by coordinates:
{
"action": "get_street_view_image",
"latitude": 48.8584,
"longitude": 2.2945,
"heading": 0,
"fov": 60
}
get_satellite_image
Retrieve a satellite, roadmap, hybrid, or terrain image for a location. Provide either an address or latitude/longitude coordinates.
Required fields:
action–"get_satellite_image"address(string) orlatitude+longitude(numbers) – The target location
Optional fields:
zoom(integer, 0-21) – Zoom level. Default: 18. Higher values are more zoomed in (e.g., 15 = neighborhood, 18 = building-level, 21 = maximum detail).map_type(string) – One of"satellite","roadmap","hybrid","terrain". Default:"satellite".image_width(integer, max 640) – Image width in pixels. Default: 640.image_height(integer, max 640) – Image height in pixels. Default: 640.
Response includes: signed_url (image link to present to user), image_base64, file_id, size_bytes, zoom, map_type
Example – satellite by coordinates:
{
"action": "get_satellite_image",
"latitude": 37.4219999,
"longitude": -122.0840575,
"zoom": 18,
"map_type": "satellite"
}
Example – hybrid map by address:
{
"action": "get_satellite_image",
"address": "Central Park, New York, NY",
"zoom": 15,
"map_type": "hybrid"
}
Common Workflows
- Address lookup then imagery – Use
geocodeto get coordinates for an address, then pass those coordinates toget_street_view_imageorget_satellite_image. - Identify a location from coordinates – Use
reverse_geocodeto find the address, then optionally get Street View imagery for context. - Compare views – Get both a Street View image (ground-level) and a satellite image (aerial) of the same location for a complete visual overview.
Important Notes
- Image URLs: Always present the
signed_urlfrom image responses to the user so they can view the image. URLs expire after 7 days. - Location input: For image actions, provide either
addressor bothlatitudeandlongitude-- not both styles at once. - Street View availability: Not all locations have Street View coverage. The response includes
available: falsewhen imagery is unavailable. - Image dimensions: Maximum image size is 640x640 pixels.
- Map types:
satelliteshows raw aerial imagery,hybridoverlays road labels on satellite,roadmapshows a standard map,terrainshows elevation features.







