Frage

Sie migrieren von PTV xServer (XRoute, XLocate, XMap) zu PTV Developer APIs und verwenden derzeit einen callerContext-Block wie:

"callerContext": {
  "properties": [
    { "key": "CoordFormat", "value": "OG_GEODECIMAL" },
    { "key": "ResponseGeometry", "value": "PLAIN" },
    { "key": "Profile", "value": "mg-truck-40t" }
  ]
}

Sie möchten verstehen, wie diese Parameter in den neuen APIs gehandhabt werden sollen.

Antwort

Das callerContext-Konzept existiert in den PTV Developer APIs nicht mehr.
Alle Parameter müssen nun explizit im Anfragekörper oder als Abfrageparameter definiert werden.

Parameterzuordnung

➤ CoordFormat

• Nicht mehr erforderlich
• Koordinaten werden implizit mit WGS84 (Breitengrad/Längengrad) behandelt

 Referenz: https://developer.myptv.com/en/documentation/map-matching-api/concepts/position-matching

➤ ResponseGeometry

• Gesteuert über Anforderungsoptionen (z. B. Geometrieformat wie Polyline)

Referenzen: 

• https://developer.myptv.com/en/documentation/data-api/data-api-reference
• https://developer.myptv.com/en/documentation/data-api/concepts/custom-road-attributes

➤ Profile

• Direkt angegeben über den profile-Parameter in der Anfrage

Referenz: https://developer.myptv.com/en/documentation/data-api/concepts/profiles

Zusätzliche Hinweise

• Die Migration erfordert eine explizite Parameterdefinition → kein implizites Verhalten über den Kontext.
• Überprüfen Sie stets die API-spezifischen Anfrageschemata (Routing, Geocoding, Karten unterscheiden sich).
• Diese Änderung verbessert die Übersichtlichkeit und Wartbarkeit der Anfragen.

Verwandte Artikel

PTV Developer: Migration von xServer zu PTV Developer
PTV Developer API Dokumentation