# Google Maps Geocoding API

> Google Maps Geocoding API is a paid API for AI agents from Google Maps at googlemaps.mpp.tempo.xyz, paid per call via MPP, $0.005/call, status unknown (last checked 2026-10-12, last successful call 2026-05-08).

Geocode a human-readable address into geographic coordinates, or reverse-geocode coordinates into a formatted address

## Facts

- Endpoint: GET https://googlemaps.mpp.tempo.xyz/maps/geocode/json?utm_source=zero.xyz
- Price: $0.005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-05-08
- Success rate: 60% of calls made through Zero
- Activations on Zero: 6
- Provider: Google Maps
- Docs: https://developers.google.com/maps
- Website: https://developers.google.com/maps
- Tags: maps, google, geocoding, directions, places, routes, tiles, weather, air-quality, solar, roads, pollen, geolocation, aerial, validation, data
- Canonical page: https://www.zero.xyz/c/google-maps-json-b3c3ee6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aGl6eV-30YCjCHeRKABeT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-maps-json-b3c3ee6f
```

Example prompt: What are the latitude and longitude coordinates for 1600 Amphitheatre Parkway, Mountain View, CA? Also give me the full formatted address and address components.

## When to prefer this

Use this endpoint when you need to convert addresses to geographic coordinates or coordinates to addresses using Google's authoritative geocoding data. Prefer this over other geocoding providers when accuracy, global coverage, and Google's comprehensive address database are important. Ideal for address normalization, map pin placement, and location enrichment workflows.

## Known failure modes

- Address not found — ZERO_RESULTS status returned when the address cannot be geocoded
- Invalid request — REQUEST_DENIED if API key is missing or unauthorized
- Over query limit — OVER_DAILY_LIMIT or OVER_QUERY_LIMIT when usage quota is exceeded
- Ambiguous address — multiple results returned when address is not specific enough
- Invalid coordinates — error or empty results when lat/lng values are out of range

## How this service works

Geocode an address or reverse-geocode coordinates

## Output

Returns geocoding results including latitude/longitude coordinates, formatted address string, address components (street number, route, city, state, country, postal code), place ID, location type (ROOFTOP, RANGE_INTERPOLATED, etc.), and viewport bounds. For reverse geocoding, returns the matching formatted address and components for the given coordinates.

## Example request

```json
{
 "address": "1600 Amphitheatre Parkway, Mountain View, CA 94043"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-maps-json-b3c3ee6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from googlemaps.mpp.tempo.xyz](https://www.zero.xyz/host/googlemaps.mpp.tempo.xyz/llms.txt)