Address
An Address represents a postal address, of official or proprietary designation, associated with an element of a venue.
Object Structure
- Address objects are unlocated Feature objects
- Address objects MUST have an
"id"
member with aFEATURE-ID
value - Address objects MUST have a
"feature_type"
member with the value"address"
- Address objects MUST have a
"geometry"
member with anull
value
Property Keys
Property | Type | Description |
---|---|---|
address |
STRING |
Formatted postal address, excluding suite/unit identifier, i.e. "123 E. Main Street" |
unit |
null or STRING |
Qualifying official or proprietary unit/suite designation, i.e. "2A" |
locality |
STRING |
Official locality (e.g. city, town) component of the postal address |
province |
null or ISO 3166-2 |
Province (e.g. state, territory) component of the postal address |
country |
ISO 3166 |
Country component of the postal address |
postal_code |
null or STRING |
Mail sorting code associated with the postal address |
postal_code_ext |
null or STRING |
Mail sorting code extension associated with the postal code |
postal_code_vanity |
null or STRING |
Mail sorting vanity code that is recognized by the postal delivery service |
Example
# unqualified building address
{
"id": "11111111-1111-1111-1111-111111111111",
"type": "Feature",
"feature_type": "address",
"geometry": null,
"properties": {
"address": "123 E. Main Street",
"unit": null,
"locality": "Anytown",
"province": "US-CA",
"country": "US",
"postal_code": "12345",
"postal_code_ext": "1111"
}
},
# unit-qualified address
{
"id": "22222222-2222-2222-2222-222222222222",
"type": "Feature",
"feature_type": "address",
"geometry": null,
"properties": {
"address": "123 E. Main Street",
"unit": "1A",
"locality": "Anytown",
"province": "US-CA",
"country": "US",
"postal_code": "12345",
"postal_code_ext": "1111"
}
},
...
Property Capturing Rules
- A distinct Address record MUST be present for each unit-qualified postal address of significance for communications delivery, routing, search or display
- A distinct Address record MUST be present for each unqualified Building level address in the dataset
ADDRESS
- SHOULD possess an address format that is expected or customary for the country in which the feature is located
- MUST include the name of a Building or Venue (whichever is most applicable) when a street address legitimately does not exist
Illustration
A Venue that does not possess a street address. The Venue's name is applicable for use in this circumstance.
{
"id": "11111111-1111-1111-1111-111111111111",
"type": "Feature",
"feature_type": "address",
"geometry": null,
"properties": {
"address": "Buckingham Palace",
"unit": null,
"locality": "London",
"province": "GB-ENG",
"country": "GB",
"postal_code": "SW1A 1AA",
"postal_code_ext": null
}
},
...
PROVINCE
- MUST be present when defined by the ISO for the Country
UNIT
- MUST NOT be a concatenation of multiple distinct unit values
- MUST be present when officially recognized and used by a postal delivery service. Reference
- MUST be present when it is a proprietary designation, and the Venue Organization wishes to enable "snap-to" functionality between an Occupant and the Anchor point referencing the target Address