Vraag

U migreert van PTV xServer (XRoute, XLocate, XMap) naar PTV Developer APIs en gebruikt momenteel een callerContext-blok zoals:

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

U wilt begrijpen hoe deze parameters in de nieuwe API's moeten worden behandeld.

Antwoord

Het callerContext-concept bestaat niet meer in PTV Developer APIs.
Alle parameters moeten nu expliciet in de request body of queryparameters worden gedefinieerd.

Parameter Mapping

➤ CoordFormat

• Niet langer vereist
• Coördinaten worden impliciet behandeld met WGS84 (breedtegraad/lengtegraad)

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

➤ ResponseGeometry

• Wordt geregeld via requestopties (bijv. geometrieformaat zoals polyline)

Referenties: 

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

➤ Profile

• Direct gespecificeerd via de profile-parameter in het verzoek

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

Aanvullende tips

• Migratie vereist expliciete parameterdefinitie → geen impliciet gedrag via context.
• Bekijk altijd de API-specifieke requestschemas (Routing, Geocoding, Maps verschillen).
• Deze wijziging verbetert de duidelijkheid en onderhoudbaarheid van verzoeken.

Gerelateerde artikelen

PTV Developer: Migreren van xServer naar PTV Developer
PTV Developer API Documentatie