Create and manage locations

Location management overview:

One of the most important factors in transportation management is the location database. The accuracy and completeness of the data is very important.

Tutorial Content

• Step 1: Create location

  • Create a new location based on an address
  • API Call Example:
    POST /api/location
    {
      "name": "Location name",
      "administrativeReference": {
        "name": "address name", 
        "street": "street", 
        "houseNumber": "housenumber", 
        "houseNumberAddition": "addition",
        "postalCode": "postalcode", 
        "city": "city",
        "country": "NL"
      }
    }
    

• Step 2: check if a location may be a duplicate

  • Identify if a location is already known in the system. The result will give the other duplicates it has found
  • API Call Example:
    POST /api/location/duplicates
    {
      "name": "Location name",
      "administrativeReference": {
        "name": "address name", 
        "street": "street", 
        "houseNumber": "housenumber", 
        "houseNumberAddition": "addition",
        "postalCode": "postalcode", 
        "city": "city",
        "country": "NL"
      }
    }
    

• Step 3: update a location

  • Update a location, you can give the fields that you want to update. It's important that you provide an identifier
  • API Call Example:
    POST /api/location
    {
      "id": "uuid",
      "name": "updated location name"
    }
    

Outcome

You successfully created a location, ensured that no duplicate of this location exists. Also the posibility to update location