Question

Vous migrez de PTV xServer (XRoute, XLocate, XMap) vers PTV Developer APIs et utilisez actuellement un bloc callerContext comme :

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

Vous souhaitez comprendre comment ces paramètres doivent être gérés dans les nouvelles API.

Réponse

Le concept callerContext n'existe plus dans les PTV Developer APIs.
Tous les paramètres doivent désormais être définis explicitement dans le corps de la requête ou les paramètres de requête.

Correspondance des paramètres

➤ CoordFormat

• N'est plus requis
• Les coordonnées sont gérées implicitement en utilisant WGS84 (latitude/longitude)

 Référence : https://developer.myptv.com/en/documentation/map-matching-api/concepts/position-matching

➤ ResponseGeometry

• Contrôlé via les options de la requête (par exemple format de géométrie tel que polyline)

Références : 

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

➤ Profile

• Spécifié directement via le paramètre profile dans la requête

Référence : https://developer.myptv.com/en/documentation/data-api/concepts/profiles

Conseils supplémentaires

• La migration nécessite une définition explicite des paramètres → pas de comportement implicite via le contexte.
• Toujours vérifier les schémas de requête spécifiques à l'API (Routing, Geocoding, Maps diffèrent).
• Ce changement améliore la clarté et la maintenabilité des requêtes.

Articles connexes

PTV Developer : Migration de xServer vers PTV Developer
Documentation des API PTV Developer