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 a FEATURE-ID value
• Address objects MUST have a "feature_type" member with the value "address"
• Address objects MUST have a "geometry" member with a null 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