Optional Responses
Last updated
Last updated
In addition to getting a placekey and a query_id, you can request as many of these additional fields as you would like within the fields parameter of the request. Full queries with these included are in the . For now:
"options":{"fields":["building_placekey","address_placekey", "confidence_score", "normalized_address", "geocode, "upi","geoid","parcel", "gers"]
An address_placekey is a subcomponent of a Placekey that has the location_name not included in the request. An address_placekey can also specifically be requested in the options parameter.
For the query: Starbucks, 48750 Seminole Dr Ste 105, Cabazon, CA, 92230, the address_placekey represets just the placekey for the address (with no location_name): 48750 Seminole Dr Ste 105, Cabazon, CA, 92230
The response will either start with 0kiksjkpg4@5vg-7gq-tvz or be formatted in like 22m@5qc-wcx-2x5. Please consdier both formats as valid strings.
A building_placekey is a subcomponent of the address_placekey. It represents the query that goes into the address_placekey without the suite or apartment number.
Note: it does not necessary represent the "building" but just the postal address.
For the query: Starbucks, 48750 Seminole Dr Ste 105, Cabazon, CA, 92230, the building_placekey represets just the placekey for the address with the suite number stripped out: 48750 Seminole Dr, Cabazon, CA, 92230
A confidence_score reflects the level of confidence in the accuracy of the assigned Placekey. Various factors such as the quality of input data, the precision of geographical coordinates and address information, and the comprehensiveness of available reference data all contribute to this score.
The more input paramaters used will likely lead to higher confidence
A normalized_address is a structured and parsed representation of an address, ensuring consistency across datasets. It breaks down the address into key components for easier matching, deduplication, and integration with other data sources.
The normalized_address is always returned with a Placekey and can be explicitly requested in the options parameter.
A geocode represents the process of converting an address or place description into precise geographic coordinates (latitude and longitude). This allows for accurate mapping and spatial analysis of locations, helping to pinpoint specific places on a map, integrate location data, or conduct geographic searches.
A parcel is a unique identifier assigned to a specific piece of land by a local government or tax authority. This number is used to track property ownership, taxation, and legal descriptions of the land. This is especially useful for real estate professionals, developers, and government agencies who need precise and up-to-date property data for various applications.
A geoid, or Geographic Identifier, is a code that uniquely identifies a specific geographic area, such as a census block, tract, county, or state. It is often used in demographic and spatial analysis to link geographic areas to census data or other geographic datasets. When your API returns a GEOID, it allows users to accurately associate data with specific locations, facilitating tasks like demographic analysis, redistricting, or regional planning. This is particularly valuable if you need to analyze data across different geographic regions.
(upi) developed by is a standard for a single identifier that includes both parcel numbers and the geographies of the authorities that created them. By implementing a UPI within property information records, data providers and consumers can improve data alignment across systems and avoid parcel number collisions.
A gers is an id provided by . Overture Overture has some super cool data on places in the US. You can return gers along with a placekey to make it easy to join other datasets to the Overture Maps open datasets.