Geocoding
Convert between coordinates and place names. Use reverse geocoding to resolve coordinates, forward search to look up cities and ZIP codes, and autosuggest for real-time search interfaces.
Operations
Convert latitude/longitude coordinates to a place name (city, state, county, timezone). Useful for resolving GPS readings before a weather request.
Location autocomplete from partial user input. Returns ranked suggestions for search bars and location pickers.
Look up coordinates by city/state or US ZIP code. Returns the canonical location plus metadata.
When to use which
- Building a location picker? Use autosuggest as the user types and forward search when they pick a result or paste a ZIP code.
- Have device coordinates? Run them through reverse geocode to get a human-readable label before calling the weather endpoint.
- Bulk-importing addresses? Use forward search for the city/state or ZIP-keyed paths and fall back to autosuggest for ambiguous strings.
Geocoding reference
Coming with Phase 2. The geocoding operations land in the canonical OpenAPI document during the Phase 2 implementation (issue #7258). Until then, see the REST API introduction for the resources already published.