# Reverse Geocoding via Google Maps (OpenWeb Ninja)

> Reverse Geocoding via Google Maps (OpenWeb Ninja) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns place and address details for a given latitude/longitude coordinate pair by performing reverse geocoding against Google Maps data.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-business-data/reverse-geocoding?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-reverse-geocoding-via-google-maps-openweb-ninja-95e51148
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v-ak1jfpummUKVhMjiTJi

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 agents-openwebninja-com-reverse-geocoding-via-google-maps-openweb-ninja-95e51148
```

Example prompt: What place or address is at latitude 40.6958453, longitude -73.9799119? Give me the full business details including name, address, and category in English for the US region.

## When to prefer this

Choose this endpoint when you have geographic coordinates (lat/lng) and need to identify the place, business, or address at that location — especially when you want rich Google Maps business metadata (ratings, categories, website, attributes) beyond a simple address string. Prefer this over forward-geocoding endpoints when you are starting from coordinates rather than a name or address.

## Known failure modes

- Invalid or out-of-range lat/lng values return an error or empty data array
- Coordinates in the middle of an ocean or unpopulated area may return no results
- Unsupported region or language codes may default to base behavior or return an error
- Rate limiting or quota exhaustion returns a 402 or 429 status
- Truncated field projection if 'fields' parameter contains invalid field names

## How this service works

Get the details of a place or address in a specific geographic location by latitude and longitude (reverse geocoding).  
  This endpoint implements the "What's here?" functionality available on Google Maps (right click on the map).

## Output

An array of place/business objects matching the coordinates, each containing: display name, full address (street, city, state, ZIP, country, district), business type/category, Google CID, average rating, website URL, latitude/longitude, owner info, and structured attribute details (amenities, service options, etc.). Also includes request metadata (status, request_id, parameters).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lng"
 ],
 "properties": {
  "lat": {
   "type": "string",
   "default": 40.6958453,
   "example": "40.6958453",
   "description": "Latitude of the geographic coordinates to search near by."
  },
  "lng": {
   "type": "string",
   "default": -73.9799119,
   "example": "-73.9799119",
   "description": "Longitude of the geographic coordinates to search near by."
  },
  "fields": {
   "type": "string",
   "description": "A comma separated list of business fields to include in the response (field projection).  \n  By default all fields are returned."
  },
  "region": {
   "type": "string",
   "default": "us",
   "description": "Query Google Maps from a particular region or country.  \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Set the language of the results. For a list of supported language codes see *https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2*."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "business_id",
     "google_id",
     "name",
     "business_status"
    ],
    "properties": {
     "cid": {
      "type": "string",
      "nullable": true,
      "description": "Google CID (Customer ID) of the business."
     },
     "tld": {
      "type": "string",
      "nullable": true,
      "description": "Top-level domain of the business website."
     },
     "city": {
      "type": "string",
      "nullable": true,
      "description": "City of the business location."
     },
     "name": {
      "type": "string",
      "description": "Display name of the business."
     },
     "type": {
      "type": "string",
      "nullable": true,
      "description": "Primary business category as labelled by Google Maps."
     },
     "about": {
      "type": "object",
      "nullable": true,
      "properties": {
       "details": {
        "type": "object",
        "nullable": true,
        "description": "Map of attribute groups (e.g. Amenities, Crowd, Service options) to attribute name -> boolean.",
        "additionalProperties": {
         "type": "object",
         "additionalProperties": {
          "type": "boolean"
         }
        }
       },
       "summary": {
        "type": "string",
        "nullable": true,
        "description": "Free-text description of the business."
       }
      },
      "description": "Free-form summary and a structured details map of business attributes."
     },
     "state": {
      "type": "string",
      "nullable": true,
      "description": "State / region of the business location."
     },
     "rating": {
      "type": "number",
      "nullable": true,
      "description": "Average review rating (1-5) on Google Maps."
     },
     "address": {
      "type": "string",
      "nullable": true,
      "description": "Street address line of the business."
     },
     "country": {
      "type": "string",
      "nullable": true,
      "description": "ISO 3166-1 alpha-2 country code of the business location."
     },
     "website": {
      "type": "string",
      "nullable": true,
      "description": "Business website URL."
     },
     "zipcode": {
      "type": "string",
      "nullable": true,
      "description": "ZIP / postal code of the business location."
     },
     "district": {
      "type": "string",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-reverse-geocoding-via-google-maps-openweb-ninja-95e51148/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)