# Address & Place Geocoding API

> Address & Place Geocoding API is a paid API for AI agents from manyfish-seller.redcliff-d7368db1.westus2.azurecontainerapps.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Converts a free-text address, landmark, city, postal code, or place name into normalized coordinates, a structured address, IANA time zone, and current UTC offset.

## Facts

- Endpoint: POST https://manyfish-seller.redcliff-d7368db1.westus2.azurecontainerapps.io/api/v1/maps/geocode
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/address-place-geocoding-api-c841f4ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q8hQW7O6UKXuBxNq21Y6Z

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 address-place-geocoding-api-c841f4ec -d '<json body>'
```

Example prompt: Can you geocode '1600 Pennsylvania Avenue NW, Washington DC' and give me its coordinates, normalized address, and time zone — return up to 2 results in English?

## When to prefer this

Choose this endpoint when you need to convert a human-readable place name, address, or postal code into machine-usable coordinates along with a verified time zone and UTC offset in a single call. It is especially useful when your workflow requires both geolocation and time zone data together without making two separate API calls. Prefer it over reverse geocoding when you have text input rather than coordinates.

## Known failure modes

- Query string matches no known location — empty results array returned
- Ambiguous query with no bias results in low-confidence or irrelevant matches
- Invalid language code causes validation error
- Bias coordinates outside valid range (-90/90 lat, -180/180 lon) rejected
- Blank or whitespace-only query rejected by pattern validation
- Rate limiting or payment failure returns 402 or error response

## How this service works

ManyFish location resolver for forward geocoding. Convert an address, landmark, city, postal code, or place name into coordinates, normalized address components, IANA time zone, and current UTC offset.

## Output

Returns up to the requested number of geocoded results, each containing normalized latitude and longitude coordinates, a structured/normalized address string, the IANA time zone identifier (e.g. 'America/New_York'), and the current UTC offset for that location.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 5,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "pattern": ".*\\S.*",
   "minLength": 1
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
   "maxLength": 35,
   "minLength": 2
  },
  "biasLatitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90
  },
  "biasLongitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "Space Needle, Seattle",
  "results": [
   {
    "type": "PointOfInterest",
    "country": "United States",
    "latitude": 47.6205,
    "locality": "Seattle",
    "timeZone": "America/Los_Angeles",
    "longitude": -122.3493,
    "utcOffset": "-07:00",
    "confidence": "High",
    "matchCodes": [
     "Good"
    ],
    "postalCode": "98109",
    "streetName": null,
    "addressLine": "Space Needle",
    "countryCode": "US",
    "streetNumber": null,
    "adminDistrict": "Washington",
    "adminDistrict2": "King County",
    "formattedAddress": "Space Needle, Seattle, WA 98109, United States",
    "adminDistrictCode": "WA"
   }
  ],
  "utcOffsetAt": "2026-08-31T20:15:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/address-place-geocoding-api-c841f4ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from manyfish-seller.redcliff-d7368db1.westus2.azurecontainerapps.io](https://www.zero.xyz/host/manyfish-seller.redcliff-d7368db1.westus2.azurecontainerapps.io/llms.txt)