> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ping Geocoding

**Code: PG**

Ping's own ensemble geocoder — runs multiple geocoding providers in parallel and scores results by confidence to return the best match.

[Data dictionary (.xlsx)](https://data-api-dev.sovfixer.com/api/v1/datasources/PG/data_dictionary.xlsx)

**Required input:** `address`<br />
**Optional input:** `const__desc_ping`

<Note>
  When Ping.Extraction fetches this data on your behalf, the Ping JSON format
  makes these payloads available under the `external_data[PG]` key of each building.
</Note>

| **Data Element**                      | **Description**                                                                                                                                                                                                                             |
| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| confidence                            | Confidence score indicating the reliability of the returned data for the given location. `number` **Values:** 0-100                                                                                                                         |
| street\_number                        | Street number component of the address. `text` *e.g. `123`*                                                                                                                                                                                 |
| route                                 | Street name or route component of the address. `text` *e.g. `Main St`*                                                                                                                                                                      |
| location\_type                        | Indicates how precisely the coordinates represent the actual address (e.g., 'ROOFTOP') `text` *e.g. `ROOFTOP`* <details><summary>Values</summary>ROOFTOP, INTERPOLATED, GEOMETRIC\_CENTER, APPROXIMATE</details>                            |
| latitude                              | Latitude of the location. `number` *e.g. `25.7743`*                                                                                                                                                                                         |
| longitude                             | Longitude of the location. `number` *e.g. `-80.1937`*                                                                                                                                                                                       |
| formatted\_address                    | Human-readable full address (e.g., '123 Main St, Miami, FL 33133'). `text` *e.g. `123 Main St, Miami, FL 33133`*                                                                                                                            |
| address\_line\_1                      | Primary street address line of the location (e.g., '123 Main St'). `text` *e.g. `123 Main St`*                                                                                                                                              |
| address\_line\_2                      | Secondary address information of the location (e.g., Apt. 33) `text` *e.g. `Apt. 33`*                                                                                                                                                       |
| city                                  | City where the property is located (e.g., 'Miami'). `text` *e.g. `Miami`*                                                                                                                                                                   |
| postal\_code                          | Postal code (e.g., ZIP code in the US). `text` *e.g. `33133`*                                                                                                                                                                               |
| county                                | County or equivalent region for the location (e.g., 'Miami-Dade'). `text` *e.g. `Miami-Dade`*                                                                                                                                               |
| state                                 | State abbreviation (e.g., 'MA'). `text` *e.g. `MA`*                                                                                                                                                                                         |
| country                               | Country where the property is located (e.g., 'US'). `text` *e.g. `US`*                                                                                                                                                                      |
| precision                             | Precision score of the geocoding. `number` *e.g. `95`* **Values:** 0-100                                                                                                                                                                    |
| state\_name                           | Full state name. `text` *e.g. `Florida`*                                                                                                                                                                                                    |
| state\_code                           | Alternate field for state abbreviation. `text` *e.g. `FL`*                                                                                                                                                                                  |
| country\_subdivision\_name            | Full name of the state/province (e.g., 'Florida'). `text` *e.g. `Florida`*                                                                                                                                                                  |
| country\_subdivision\_code            | Abbreviated code for the state/province (e.g., 'FL'). `text` *e.g. `FL`*                                                                                                                                                                    |
| source\_desc                          | Source system that provided the geocoded data. `text` *e.g. `LBG`*                                                                                                                                                                          |
| consulted\_datasources                | List of data source codes used to generate the address result. `list[text]` *e.g. `["LBG", "GG", "EG"]`*                                                                                                                                    |
| version                               | Data source version identifier (e.g., '2.1'). `text` *e.g. `2.1`*                                                                                                                                                                           |
| candidate\_countries                  | `list[text]`                                                                                                                                                                                                                                |
| match\_level                          | Level of detail matched in the address (e.g., 'street\_imputed'). `text` *e.g. `street_imputed`* <details><summary>Values</summary>point, street\_imputed, route, postal\_code, city, county, country\_subdivision\_name, country</details> |
| ~~precision\_confidences~~            | **Deprecated.** DEPRECATED: no longer populated. Always an empty string. `text`                                                                                                                                                             |
| match\_confidence                     | Confidence level of the address match (e.g., '0.57'). `number` *e.g. `0.57`* **Values:** 0.0-1.0                                                                                                                                            |
| constructed\_address                  | The fully assembled address string built from the individual address components. `text` *e.g. `123 Main St, Miami, FL 33133`*                                                                                                               |
| used\_point\_coordinates\_from\_input | Whether the geocoding result used latitude/longitude coordinates provided in the input rather than geocoding from an address. `boolean` *e.g. `false`* **Values:** True, False                                                              |