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