Address Attributes
Address Attributes
Address Attributes expand upon the street_address
, city
, region
, and postal_code
columns in Places Base Attributes and parse the address information into much more granular parts. Address Attributes also signal whether an address is postal verified.
Note: It is not expected that any record will ever have all of these fields populated, just due to the nature of how addresses are handled in different areas. The examples provided are from many POIs and are meant to illustrate examples for each column - these values cannot be reassembled to create a single real address.
Column Name | Description | Type | Example |
---|---|---|---|
sub_building | Combined secondary designators of the location (Ste, Unit, Bldg). | String | Unit 1105 |
building_name | The name of the building for named buildings. In the US expect this column to contain named buildings and malls. | String | Eaton |
primary_number | A primary numeric identifier for the building followed by the building/structure identifier if multiple identifiers exist. | String | 4700 |
street_predirection | Directional information preceding a street name. | String | E |
street_prefix | Abbreviated value describing the street type preceding the street name. | String | Highway |
street_name | The name of the street. | String | Kingsway |
street_suffix | Abbreviated value describing the street type following a street name. | String | Ave |
street_postdirection | Directional information following a street name. | String | N |
street | All street components combined. | String | Kingsway |
street_address | A full street address containing the building, street, and secondary designator information. In the absence of a numerical building identifier or building name, a city-block or a cross-street may be specified. | String | 3734 131st Ave N Ste 13 |
street_extra | Additional street-level address information such as cross street. | String | Melbourne Ave |
full_address | A correctly formatted, multiline mailable address for the poi (US and CA only). | String | 1680 Campbell Ln Bowling Green KY 42104-1062 |
intermediate_locality | Additional details associated with the locality like sub-division of a city , neighborhood, municipality, or an associated settlement like a village. This is null where iso_country_code = 'US' or 'CA'. | String | Hohenlimburg |
locality | Additional details associated with city like a sub-division, city district, or an associated dependent settlement like "urbanization" in Puerto Rico). | String | Repto Robles |
city | The city of the point of interest. | String | Clearwater |
sub_region | The second largest administrative division in the country when appropriate. (Ex: this is county where iso_country_code = 'US'). | String | Tom |
region | The state, province, county, or equivalent of how "region" is understood in a given country for the place of interest. See region for more details. | String | Pinellas |
postal_code | The postal code of the place of interest. | String | 12235 |
postal_code_extra | The postal unit within the postal code. | String | 9872 |
sorting_code | A string immediately following city in an address block providing additional mail sorting information that does not fit within other address columns. Ex: 'Dublin 16' where 'Dublin' = city and '16' = sorting_code | String | 16 |
is_intersection | Indicates whether the street_address is provided in a form of an intersection. | Boolean | False |
mailing_verified_status | Mailing verification status of the address per country-relevant postal source. Possible values are: VERIFIED_DELIVERY_POINT , VERIFIED_PREMISE (up to a building), NOT_VERIFIED . | String | VERIFIED_DELIVERY_POINT |
mailing_verified_id | A unique id associated with the mailing verification source relevant for a country. Ex: delivery point barcode for iso_country_code = US | String | 337624222135 |
alt_address | Contains alternative names for address fields. Currently only contains alternate city names. Ex: city = 'Atlanta' and alt_address.city = 'Sandy Springs' | JSON {String: String} | Sandy Springs |
land_use_class | Designates whether a street_address is Commercial or Residential per the country's postal authority. Unknown addresses are null; available in iso_country_code = 'US' only. | String | Commercial |
Updated 5 months ago