Resolve place names to canonical Place ids
Resolve a place name to canonical Govly Place ids — counties, municipalities, states, ZIP codes, school districts, military installations, and countries. Results are ordered records-bearing first; hasRecords false means the place exists in the gazetteer but matches no opportunities or awards, so filtering by it returns nothing. nameMatch reports how the name matched: treat semantic as a prompt to confirm with the user, since vernacular geography such as “the Bay Area” has no canonical record and resolves to the nearest thing. partial is expected for county and municipality lookups, because canonical names carry a category suffix. isoCodes matches the place’s own code exactly and is not a hierarchy — “US” matches only the country record, so use “US-XX” to scope inside a state, while a bare foreign code such as “JP” correctly scopes overseas military installations. Place ids are market-agnostic, but opportunity and award searches are market-scoped, so a returned id may not be searchable under the caller’s subscription. Results are relevance-ranked and cursor-paginated: pass meta.nextCursor back as cursor until it is absent. Paging walks the matches for a query, it does not enumerate a category — no text query matches all 58 California counties.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The place name to resolve, such as "redstone arsenal".
200Restrict to these place categories, to disambiguate a name shared across categories.
postal_code, county, municipality, region, country, military_installation, school_district Restrict to these jurisdiction codes, matched exactly (e.g. US-NC). Not hierarchical — "US" matches only the country record.
Opaque cursor from the previous response's meta.nextCursor. Omit for the first page. Only valid for the exact query, categories, and isoCodes that produced it.
Results per page. Default 25, maximum 100.
x <= 100