place

November 12, 2025 · View on GitHub

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

Type: object

semantics [{'transmodel': 'POSTAL ADDRESS'}]


Properties overview

PropertyTypeRequiredDescription
idplaceReferencethis string references to information that can be found in the data sources...
typestring
addressLine1longStringcontains street, housenumber & additions example street 18, 2nd floor, 18-B33
addressLine2longStringcity or town, principal subdivision such as province, state or county Smallci...
streetnormalStringstreet, consistent with addressLine1
houseNumbernormalInthouse number, consistent with addressLine1
houseNumberAdditiontinyStringthe additional part of the house number (f.x. 13bis, where 'bis' is the addit...
postalCodeshortStringthe postal code, whenever available
cityshortStringspecified city or town, consistent with addressLine2
provinceshortStringprovince or region, consistent with addressLine2
stateshortStringstate, consistent with addressLine2
countrycountrytwo-letter country codes according to ISO 3166-1
additionalInfolongStringadditional information to find the address (f.x. just around the corner)

Detailed Properties

  • id (placeReference) - required
    value: "GPS|gps|{datasource-prefix}|P:[a-zA-Z0-9-_.]+" this string references to information that can be found in the data sources. Enlist all prefixes (=rel) from the /collections/datasources/items that apply to a place/location. Default it matches already with 'GPS' (no entry required in the datasources). In case of a custom place (like home address), you can use the 'P:' prefix and add the address to the places list of the request/offer/package.

  • type (string) - optional
    value: "place"

  • addressLine1 (longString) - required
    contains street, housenumber & additions example street 18, 2nd floor, 18-B33

  • addressLine2 (longString) - optional
    city or town, principal subdivision such as province, state or county Smallcity, Pinetree county

  • street (normalString) - optional
    street, consistent with addressLine1

  • houseNumber (normalInt) - optional
    house number, consistent with addressLine1 default: 0

  • houseNumberAddition (tinyString) - optional
    the additional part of the house number (f.x. 13bis, where 'bis' is the additional part), consistent with addressLine1

  • postalCode (shortString) - optional
    the postal code, whenever available

  • city (shortString) - optional
    specified city or town, consistent with addressLine2

  • province (shortString) - optional
    province or region, consistent with addressLine2

  • state (shortString) - optional
    state, consistent with addressLine2

  • country (country) - optional
    value: "[A-Z]{2}" two-letter country codes according to ISO 3166-1

  • additionalInfo (longString) - optional
    additional information to find the address (f.x. just around the corner)

Additional Properties

❌ No additional properties are allowed.

Example

{
  "id": "GPS|gps|{datasource-prefix}|P:[a-zA-Z0-9\\-_.]+",
  "addressLine1": "example-string",
  "type": "place",
  "addressLine2": "example-string",
  "street": "example-string"
}