# Optional Responses

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 [example queries section](https://docs.placekey.io/documentation/placekey-api/example-queries). For now:

`"options":{"fields":["building_placekey","address_placekey", "confidence_score", "normalized_address", "geocode, "upi","geoid","parcel", "gers"]`

## address\_placekey

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. 

## building\_placekey

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

## confidence\_score

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

## normalized\_address

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.

## Geocode

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.

## Universal Parcel Identifier (UPI)

[Universal Parcel Identifier](https://github.com/RESOStandards/reso-upi) (`upi`) developed by [RESO](https://www.reso.org/) 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.

## Parcel Number

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.

## GEOID

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.

## GERS

A `gers` is an id provided by [Overture Maps](https://overturemaps.org/). 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.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.placekey.io/documentation/placekey-api/response/optional-responses.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.