Use PlaceField when
Your app stores a city, administrative area, region, or country and needs stable IDs, hierarchy, country, and coordinates.
Focused alternative
PlaceField is for apps, backends, and forms that need structured location autocomplete or place-level geocoding, not a full maps platform. Use it when you want city, region, and country suggestions without street addresses, businesses, POIs, routes, or map UI.
Your app stores a city, administrative area, region, or country and needs stable IDs, hierarchy, country, and coordinates.
You need address autocomplete, POI search, business listings, routing, reverse geocoding, map tiles, or street-level precision.
Signup forms, profile location fields, marketplace listings, backend workflows, CRM records, directories, communities, and privacy-friendly city-level forms.
Google Places Autocomplete is broad by design. PlaceField is deliberately narrow: it returns administrative places your application can store directly, with structured JSON instead of a formatted address-like result your code has to interpret.
Prioritize places that belong in a location field, not shops, venues, street names, or address fragments.
Store stable IDs, place type, hierarchy, country, and coordinates without scraping a display label.
Use the location autocomplete API directly, attach behavior to your own input, or ship the full JavaScript widget.
No map UI, no routing, no reverse geocoding, and no POI search. Just focused location autocomplete for apps, backends, and forms.
PlaceField can be added as a direct API call or as a browser widget. Production browser keys use exact origin allowlists, and server keys stay behind your backend.
PlaceField.widget("#city", {
endpoint: "https://api.placefield.dev/v1/locations/autocomplete",
key: "pf_pub_xxx",
geoBias: "country",
mobile: "fullscreen"
});
If your product or form only needs city, region, or country data, a full address autocomplete product may be more than you need.
For the broader field decision, use the location autocomplete guide.
Compare city and address autocompleteUse PlaceField for the limited case where an app needs place search, administrative context, and coordinates. Use a maps or geocoding platform when you need addresses, reverse geocoding, POIs, routes, or map UI.
View city geocoding use caseShare the integration you are building and whether you need API, Basic JS, or the full location autocomplete widget.