# Location Resolver

> Location Resolver is a paid API for AI agents from location-resolver.victoriousbush-c7c267a1.westus2.azurecontainerapps.io, paid per call via x402, $0.002/call, status down (last checked 2026-09-15).

Converts addresses, landmarks, postal codes, or coordinates into structured location data including lat/lng, normalized address, IANA time zone, and UTC offset — supporting both forward and reverse geocoding.

## Facts

- Endpoint: POST https://location-resolver.victoriousbush-c7c267a1.westus2.azurecontainerapps.io/location-resolve
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/location-resolver-92e22f1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yau5LHVycj6goLagKSozR

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 location-resolver-92e22f1d -d '<json body>'
```

Example prompt: Can you resolve '1600 Amphitheatre Parkway, Mountain View, CA' into structured location data — I need the latitude, longitude, normalized address, and IANA time zone?

## When to prefer this

Choose this endpoint when you need combined forward and reverse geocoding with time zone data in a single call, especially when you need the IANA time zone identifier and UTC offset alongside lat/lng. Prefer this over pure geocoding APIs when time zone awareness is critical (e.g. scheduling, event planning, delivery routing). The bias parameters make it useful for apps that need region-aware result ranking without a full maps SDK.

## Known failure modes

- Ambiguous place name with no bias coordinates may return unexpected region results
- Invalid or unrecognized address string returns empty results or error
- Coordinates outside valid range (-90 to 90 lat, -180 to 180 lng) are rejected
- Unsupported language code may fall back to default language
- Missing both query and lat/lng fields returns a validation error

## How this service works

Resolve an address, landmark, city, postal code, or coordinates into structured location data with latitude, longitude, normalized address, IANA time zone, and current UTC offset. Supports forward and reverse geocoding in one endpoint.

## Output

Returns up to 5 structured location results per call, each containing latitude, longitude, a normalized/formatted address, the IANA time zone identifier (e.g. 'America/Los_Angeles'), and the current UTC offset. Supports both forward geocoding (query string to coordinates) and reverse geocoding (coordinates to address).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 5,
   "minimum": 1,
   "description": "Maximum results for forward geocoding. Defaults to 3."
  },
  "query": {
   "type": "string",
   "description": "Address, landmark, city, postal code, or place name to resolve."
  },
  "language": {
   "type": "string",
   "description": "Preferred result language, e.g. en-US or zh-CN."
  },
  "latitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Latitude for reverse geocoding. Use together with longitude instead of query."
  },
  "longitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Longitude for reverse geocoding. Use together with latitude instead of query."
  },
  "biasLatitude": {
   "type": "number",
   "maximum": 90,
   "minimum": -90,
   "description": "Optional latitude used to bias forward-geocode ranking."
  },
  "biasLongitude": {
   "type": "number",
   "maximum": 180,
   "minimum": -180,
   "description": "Optional longitude used to bias forward-geocode ranking."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/location-resolver-92e22f1d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from location-resolver.victoriousbush-c7c267a1.westus2.azurecontainerapps.io](https://www.zero.xyz/host/location-resolver.victoriousbush-c7c267a1.westus2.azurecontainerapps.io/llms.txt)