Traffic Point Elements API Guide

Read TrafficPointElements - Successfully

GET /v1/traffic-point-elements

Query Parameters

Parameter	Type	Optional	Description
sloids	Array[String]	true
servicePointNumbers	Array[String]	true
parentsloids	Array[String]	true
sboids	Array[String]	true
parentServicePointSloids	Array[String]	true
uicCountryCodes	Array[String]	true
servicePointNumbersShort	Array[String]	true
trafficPointElementType	String	true	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
validOn	String	true
fromDate	String	true
toDate	String	true
validToFromDate	String	true
createdAfter	String	true
modifiedAfter	String	true
page	Integer	true
size	Integer	true
sort	Array[String]	true

Parameter

Type

Optional

Description

sloids

Array[String]

true

servicePointNumbers

Array[String]

true

parentsloids

Array[String]

true

sboids

Array[String]

true

parentServicePointSloids

Array[String]

true

uicCountryCodes

Array[String]

true

servicePointNumbersShort

Array[String]

true

trafficPointElementType

String

true

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

validOn

String

true

fromDate

String

true

toDate

String

true

validToFromDate

String

true

createdAfter

String

true

modifiedAfter

String

true

page

Integer

true

size

Integer

true

sort

Array[String]

true

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1329

{
  "objects" : [ {
    "creationDate" : "2025-05-26T10:58:56.2212",
    "creator" : "e123456",
    "editionDate" : "2025-05-26T10:58:56.221203",
    "editor" : "e123456",
    "status" : null,
    "id" : 1037,
    "designation" : "Bezeichnung",
    "designationOperational" : "gali00",
    "length" : null,
    "boardingAreaHeight" : null,
    "compassDirection" : 277.0,
    "trafficPointElementType" : "BOARDING_PLATFORM",
    "sloid" : "ch:1:sloid:1400015:0:310240",
    "parentSloid" : "ch:1:sloid:1400015:310240",
    "validFrom" : "2020-01-06",
    "validTo" : "2099-12-31",
    "etagVersion" : 0,
    "servicePointNumber" : {
      "number" : 1400015,
      "numberShort" : 15,
      "checkDigit" : 8,
      "uicCountryCode" : 14
    },
    "servicePointSloid" : "ch:1:sloid:1400015",
    "trafficPointElementGeolocation" : {
      "spatialReference" : "LV95",
      "lv95" : {
        "north" : 1116323.213,
        "east" : 2505236.389,
        "spatialReference" : "LV95"
      },
      "wgs84" : {
        "north" : 46.19168377864,
        "east" : 6.21113066932,
        "spatialReference" : "WGS84"
      },
      "lv03" : {
        "north" : 116323.213,
        "east" : 505236.389,
        "spatialReference" : "LV03"
      },
      "height" : -9999.0
    },
    "hasGeolocation" : true
  } ],
  "totalCount" : 1
}

Read TrafficPointElement by SLOID - Successfully

GET /v1/traffic-point-elements/ch:1:sloid:1400015:0:310240

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false

Path Variable

Type

Optional

Description

sloid

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/ch:1:sloid:1400015:0:310240' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1203

[ {
  "creationDate" : "2025-05-26T10:58:56.030736",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:56.030739",
  "editor" : "e123456",
  "status" : null,
  "id" : 1034,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
} ]

Read TrafficPointElement by ID - Successfully

GET /v1/traffic-point-elements/versions/1031

Path Variables

Path Variable	Type	Optional	Description
id	Integer	false

Path Variable

Type

Optional

Description

Integer

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/versions/1031' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1199

{
  "creationDate" : "2025-05-26T10:58:55.898382",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:55.898384",
  "editor" : "e123456",
  "status" : null,
  "id" : 1031,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
}

Read TrafficPointElement by ServicePointNumbers - Successfully

GET /v1/traffic-point-elements/123

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false

Path Variable

Type

Optional

Description

sloid

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/123' -i -X GET

Example response

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 393

{
  "status" : 404,
  "message" : "Entity not found",
  "error" : "Not found",
  "details" : [ {
    "message" : "Object with sloid 123 not found",
    "field" : "sloid",
    "displayInfo" : {
      "code" : "ERROR.ENTITY_NOT_FOUND",
      "parameters" : [ {
        "key" : "field",
        "value" : "sloid"
      }, {
        "key" : "value",
        "value" : "123"
      } ]
    }
  } ]
}

Read TrafficPointElement by SLOID - NotFound

GET /v1/traffic-point-elements/123

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false

Path Variable

Type

Optional

Description

sloid

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/123' -i -X GET

Example response

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 393

{
  "status" : 404,
  "message" : "Entity not found",
  "error" : "Not found",
  "details" : [ {
    "message" : "Object with sloid 123 not found",
    "field" : "sloid",
    "displayInfo" : {
      "code" : "ERROR.ENTITY_NOT_FOUND",
      "parameters" : [ {
        "key" : "field",
        "value" : "sloid"
      }, {
        "key" : "value",
        "value" : "123"
      } ]
    }
  } ]
}

Read TrafficPointElement by ParentServicePointSloids - Successfully

GET /v1/traffic-point-elements

Query Parameters

Parameter	Type	Optional	Description
sloids	Array[String]	true
servicePointNumbers	Array[String]	true
parentsloids	Array[String]	true
sboids	Array[String]	true
parentServicePointSloids	Array[String]	true
uicCountryCodes	Array[String]	true
servicePointNumbersShort	Array[String]	true
trafficPointElementType	String	true	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
validOn	String	true
fromDate	String	true
toDate	String	true
validToFromDate	String	true
createdAfter	String	true
modifiedAfter	String	true
page	Integer	true
size	Integer	true
sort	Array[String]	true

Parameter

Type

Optional

Description

sloids

Array[String]

true

servicePointNumbers

Array[String]

true

parentsloids

Array[String]

true

sboids

Array[String]

true

parentServicePointSloids

Array[String]

true

uicCountryCodes

Array[String]

true

servicePointNumbersShort

Array[String]

true

trafficPointElementType

String

true

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

validOn

String

true

fromDate

String

true

toDate

String

true

validToFromDate

String

true

createdAfter

String

true

modifiedAfter

String

true

page

Integer

true

size

Integer

true

sort

Array[String]

true

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements?parentServicePointSloids=ch:1:sloid:1400015' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1331

{
  "objects" : [ {
    "creationDate" : "2025-05-26T10:58:54.172346",
    "creator" : "e123456",
    "editionDate" : "2025-05-26T10:58:54.172349",
    "editor" : "e123456",
    "status" : null,
    "id" : 1006,
    "designation" : "Bezeichnung",
    "designationOperational" : "gali00",
    "length" : null,
    "boardingAreaHeight" : null,
    "compassDirection" : 277.0,
    "trafficPointElementType" : "BOARDING_PLATFORM",
    "sloid" : "ch:1:sloid:1400015:0:310240",
    "parentSloid" : "ch:1:sloid:1400015:310240",
    "validFrom" : "2020-01-06",
    "validTo" : "2099-12-31",
    "etagVersion" : 0,
    "servicePointNumber" : {
      "number" : 1400015,
      "numberShort" : 15,
      "checkDigit" : 8,
      "uicCountryCode" : 14
    },
    "servicePointSloid" : "ch:1:sloid:1400015",
    "trafficPointElementGeolocation" : {
      "spatialReference" : "LV95",
      "lv95" : {
        "north" : 1116323.213,
        "east" : 2505236.389,
        "spatialReference" : "LV95"
      },
      "wgs84" : {
        "north" : 46.19168377864,
        "east" : 6.21113066932,
        "spatialReference" : "WGS84"
      },
      "lv03" : {
        "north" : 116323.213,
        "east" : 505236.389,
        "spatialReference" : "LV03"
      },
      "height" : -9999.0
    },
    "hasGeolocation" : true
  } ],
  "totalCount" : 1
}

Create TrafficPointElement with automatic SLOID generation - Successfully

POST /v1/traffic-point-elements

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until).

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : null,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : null,
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : null,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1116323.213,
    "east" : 2505236.389,
    "height" : -9999.0
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1196

{
  "creationDate" : "2025-05-26T10:58:55.284496",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:55.284499",
  "editor" : "e123456",
  "status" : null,
  "id" : 1020,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:123",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
}

Create TrafficPointElement with given SLOID - Successfully

POST /v1/traffic-point-elements

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : null,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : null,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1116323.213,
    "east" : 2505236.389,
    "height" : -9999.0
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1199

{
  "creationDate" : "2025-05-26T10:58:55.995576",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:55.995578",
  "editor" : "e123456",
  "status" : null,
  "id" : 1033,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
}

Update TrafficPointElement - Successfully

PUT /v1/traffic-point-elements/1003

Path Variables

Path Variable	Type	Optional	Description
id	Integer	false

Path Variable

Type

Optional

Description

Integer

false

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/1003' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : null,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2021-01-01",
  "validTo" : "2021-12-31",
  "etagVersion" : 0,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1201099.85634,
    "east" : 2600783.31256,
    "height" : 555.98
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3610

[ {
  "creationDate" : "2025-05-26T10:58:54.06187",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:54.098567",
  "editor" : "e123456",
  "status" : null,
  "id" : 1003,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2020-12-31",
  "etagVersion" : 2,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
}, {
  "creationDate" : "2025-05-26T10:58:54.104945",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:54.104947",
  "editor" : "e123456",
  "status" : null,
  "id" : 1004,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2021-01-01",
  "validTo" : "2021-12-31",
  "etagVersion" : 1,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1201099.85634,
      "east" : 2600783.31256,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.96097578277,
      "east" : 7.44892383013,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 201099.85634,
      "east" : 600783.31256,
      "spatialReference" : "LV03"
    },
    "height" : 555.98
  },
  "hasGeolocation" : true
}, {
  "creationDate" : "2025-05-26T10:58:54.11024",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:54.110244",
  "editor" : "e123456",
  "status" : null,
  "id" : 1005,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2022-01-01",
  "validTo" : "2099-12-31",
  "etagVersion" : 1,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
} ]

Update TrafficPointElement - Successfully

PUT /v1/traffic-point-elements/1029

Path Variables

Path Variable	Type	Optional	Description
id	Integer	false

Path Variable

Type

Optional

Description

Integer

false

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/1029' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : null,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1201099.85634,
    "east" : 2600783.31256,
    "height" : 555.98
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1210

[ {
  "creationDate" : "2025-05-26T10:58:55.797217",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:55.817619",
  "editor" : "e123456",
  "status" : null,
  "id" : 1029,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 2,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1201099.85634,
      "east" : 2600783.31256,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.96097578277,
      "east" : 7.44892383013,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 201099.85634,
      "east" : 600783.31256,
      "spatialReference" : "LV03"
    },
    "height" : 555.98
  },
  "hasGeolocation" : true
} ]

Update TrafficPointElement - NotEqualSloids

PUT /v1/traffic-point-elements/1018

Path Variables

Path Variable	Type	Optional	Description
id	Integer	false

Path Variable

Type

Optional

Description

Integer

false

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/1018' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : 1018,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310241",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : null,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1116323.213,
    "east" : 2505236.389,
    "height" : -9999.0
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 200

{
  "status" : 400,
  "message" : "Sloid for provided id: ch:1:sloid:1400015:0:310240 and sloid in the request body: ch:1:sloid:1400015:0:310241 are not equal.",
  "error" : null,
  "details" : null
}

Update TrafficPointElement - OptimisticLocking

PUT /v1/traffic-point-elements/1015

Path Variables

Path Variable	Type	Optional	Description
id	Integer	false

Path Variable

Type

Optional

Description

Integer

false

Request Body Fields

Path	Type	Optional	Description
numberWithoutCheckDigit	Integer	false	Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID. Example value: 8034505
trafficPointElementGeolocation	Object	true
trafficPointElementGeolocation.spatialReference	String	false	Coordinate system spatial reference Example value: LV95 Must be one of ["WGS84WEB","LV95","LV03","WGS84"]
trafficPointElementGeolocation.north	Decimal	false	North longitude Example value: 225738.00000000000
trafficPointElementGeolocation.east	Decimal	false	Eastern longitude Example value: 681821.00000000000
trafficPointElementGeolocation.height	Decimal	true	Height of the coordinate point Example value: 540.20000
id	Integer	true	This ID helps identify versions of a traffic point element in the use case front end and/or update. This ID can be deleted if the version is no longer present. Do not use this ID to map your object to a traffic point element. To do this, use the sloid in combination with the data range (valid from/valid until). Example value: 1
designation	String	true	Designation used in the customer information systems. Example value: Bezeichnung Length must be between 0 and 40
designationOperational	String	true	Designation used in (operational) timetable planning. Example value: Bezeichnung Length must be between 0 and 20
length	Decimal	true	Length of the TrafficPointElement Example value: 18.000
boardingAreaHeight	Decimal	true	Height of BoardingArea at the TrafficPointElement Example value: 22.00
compassDirection	Decimal	true	Compass Direction at the TrafficPointElement Example value: 107.00
trafficPointElementType	String	false	Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]
sloid	String	true	Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established. The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here. transportdatamanagement.ch/standards/ Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
parentSloid	String	true	Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used. Example value: ch:1:sloid:16161:1 Length must be between 1 and 128
validFrom	String	false
validTo	String	false
etagVersion	Integer	true	Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3) Example value: 5
creationDate	String	true	Object creation date Example value: 01.01.2000
creator	String	true	User creator Example value: u123456
editionDate	String	true	Last edition date Example value: 01.01.2000
editor	String	true	User editor Example value: u123456
status	String	true	Status Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Path

Type

Optional

Description

numberWithoutCheckDigit

Integer

false

Seven digits number. First two digits represent Country Code. Last 5 digits represent traffic point ID.

Example value: 8034505

trafficPointElementGeolocation

Object

true

trafficPointElementGeolocation.spatialReference

String

false

Coordinate system spatial reference

Example value: LV95

Must be one of ["WGS84WEB","LV95","LV03","WGS84"]

trafficPointElementGeolocation.north

Decimal

false

North longitude

Example value: 225738.00000000000

trafficPointElementGeolocation.east

Decimal

false

Eastern longitude

Example value: 681821.00000000000

trafficPointElementGeolocation.height

Decimal

true

Height of the coordinate point

Example value: 540.20000

Integer

true

Example value: 1

designation

String

true

Designation used in the customer information systems.

Example value: Bezeichnung

Length must be between 0 and 40

designationOperational

String

true

Designation used in (operational) timetable planning.

Example value: Bezeichnung

Length must be between 0 and 20

length

Decimal

true

Length of the TrafficPointElement

Example value: 18.000

boardingAreaHeight

Decimal

true

Height of BoardingArea at the TrafficPointElement

Example value: 22.00

compassDirection

Decimal

true

Compass Direction at the TrafficPointElement

Example value: 107.00

trafficPointElementType

String

false

Must be one of ["BOARDING_PLATFORM","BOARDING_AREA"]

sloid

String

true

Unique code for traffic point element (TPE) that is used in customer information. By means of this ID, the connection between stops and bus / station stop area or boarding area can be established.

The structure is described in the “Swiss Location ID” specification, chapter 4.2. The document is available here.

transportdatamanagement.ch/standards/

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

parentSloid

String

true

Hierarchical assignment of the TPE which is to be processed to another TPE. It is a 1:1 relationship. As key, the SLOID is used.

Example value: ch:1:sloid:16161:1

Length must be between 1 and 128

validFrom

String

false

validTo

String

false

etagVersion

Integer

true

Optimistic locking version - instead of ETag HTTP Header (see RFC7232:Section 2.3)

Example value: 5

creationDate

String

true

Object creation date

Example value: 01.01.2000

creator

String

true

User creator

Example value: u123456

editionDate

String

true

Last edition date

Example value: 01.01.2000

editor

String

true

User editor

Example value: u123456

status

String

true

Status

Must be one of ["DRAFT","VALIDATED","IN_REVIEW","WITHDRAWN","REVOKED"]

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/1015' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "creationDate" : "2019-12-06T08:02:34",
  "creator" : "fs45117",
  "editionDate" : "2019-12-06T08:02:34",
  "editor" : "fs45117",
  "status" : null,
  "id" : 1015,
  "designation" : "Bezeichnung",
  "designationOperational" : "2 designation",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2099-12-31",
  "etagVersion" : 0,
  "numberWithoutCheckDigit" : 1400015,
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "north" : 1116323.213,
    "east" : 2505236.389,
    "height" : -9999.0
  },
  "hasGeolocation" : true
}'

Example response

HTTP/1.1 412 Precondition Failed
Content-Type: application/json
Content-Length: 507

{
  "status" : 412,
  "message" : "Row was updated or deleted by another transaction (or unsaved-value mapping was incorrect): [ServicePointVersion#version]",
  "error" : "Stale object state error",
  "details" : [ {
    "message" : "Row was updated or deleted by another transaction (or unsaved-value mapping was incorrect): [ServicePointVersion#version]",
    "field" : "etagVersion",
    "displayInfo" : {
      "code" : "COMMON.NOTIFICATION.OPTIMISTIC_LOCK_ERROR",
      "parameters" : [ ]
    }
  } ]
}

Terminate TrafficPointElement - Successfully

PUT /v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:310240/2024-03-03

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false
validTo	String	false

Path Variable

Type

Optional

Description

sloid

String

false

validTo

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:310240/2024-03-03' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8'

Example response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1203

[ {
  "creationDate" : "2025-05-26T10:58:54.219773",
  "creator" : "e123456",
  "editionDate" : "2025-05-26T10:58:54.253889",
  "editor" : "e123456",
  "status" : null,
  "id" : 1007,
  "designation" : "Bezeichnung",
  "designationOperational" : "gali00",
  "length" : null,
  "boardingAreaHeight" : null,
  "compassDirection" : 277.0,
  "trafficPointElementType" : "BOARDING_PLATFORM",
  "sloid" : "ch:1:sloid:1400015:0:310240",
  "parentSloid" : "ch:1:sloid:1400015:310240",
  "validFrom" : "2020-01-06",
  "validTo" : "2024-03-03",
  "etagVersion" : 2,
  "servicePointNumber" : {
    "number" : 1400015,
    "numberShort" : 15,
    "checkDigit" : 8,
    "uicCountryCode" : 14
  },
  "servicePointSloid" : "ch:1:sloid:1400015",
  "trafficPointElementGeolocation" : {
    "spatialReference" : "LV95",
    "lv95" : {
      "north" : 1116323.213,
      "east" : 2505236.389,
      "spatialReference" : "LV95"
    },
    "wgs84" : {
      "north" : 46.19168377864,
      "east" : 6.21113066932,
      "spatialReference" : "WGS84"
    },
    "lv03" : {
      "north" : 116323.213,
      "east" : 505236.389,
      "spatialReference" : "LV03"
    },
    "height" : -9999.0
  },
  "hasGeolocation" : true
} ]

Terminate TrafficPointElement - Unsuccessfully SLOID not found

PUT /v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:55555/2024-03-03

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false
validTo	String	false

Path Variable

Type

Optional

Description

sloid

String

false

validTo

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:55555/2024-03-03' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8'

Example response

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 439

{
  "status" : 404,
  "message" : "Entity not found",
  "error" : "Not found",
  "details" : [ {
    "message" : "Object with sloid ch:1:sloid:1400015:0:55555 not found",
    "field" : "sloid",
    "displayInfo" : {
      "code" : "ERROR.ENTITY_NOT_FOUND",
      "parameters" : [ {
        "key" : "field",
        "value" : "sloid"
      }, {
        "key" : "value",
        "value" : "ch:1:sloid:1400015:0:55555"
      } ]
    }
  } ]
}

Terminate TrafficPointElement - Unsuccessfully FORBIDDEN

PUT /v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:310240/2024-03-03

Path Variables

Path Variable	Type	Optional	Description
sloid	String	false
validTo	String	false

Path Variable

Type

Optional

Description

sloid

String

false

validTo

String

false

Example request

$ curl 'http://localhost:8080/v1/traffic-point-elements/terminate/ch:1:sloid:1400015:0:310240/2024-03-03' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8'

Example response

HTTP/1.1 403 Forbidden
Content-Type: application/json
Content-Length: 625

{
  "status" : 403,
  "message" : "Termination not allowed for sloid ch:1:sloid:1400015:0:310240 since the date range for the last version is from 2025-01-01 until 2030-12-31. And requested validTo value 2024-03-03 is not within the range.",
  "error" : "Termination not allowed",
  "details" : [ {
    "message" : "Termination not allowed for non latest version.",
    "field" : "termination",
    "displayInfo" : {
      "code" : "SEPODI.SERVICE_POINTS.TERMINATION_NOT_ALLOWED_FOR_NON_LATEST_VERSION",
      "parameters" : [ {
        "key" : "sloid",
        "value" : "ch:1:sloid:1400015:0:310240"
      } ]
    }
  } ]
}

< Back to main