Pregunta

Está migrando de PTV xServer (XRoute, XLocate, XMap) a PTV Developer APIs y actualmente usa un bloque callerContext como:

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

Desea entender cómo deben manejarse estos parámetros en las nuevas APIs.

Respuesta

El concepto callerContext ya no existe en PTV Developer APIs.
Todos los parámetros ahora deben definirse explícitamente en el cuerpo de la solicitud o en los parámetros de consulta.

Mapeo de parámetros

➤ CoordFormat

• Ya no es necesario
• Las coordenadas se manejan implícitamente usando WGS84 (latitud/longitud)

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

➤ ResponseGeometry

• Controlado mediante opciones de la solicitud (p. ej., formato de geometría como polilínea)

Referencias: 

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

➤ Profile

• Especificado directamente usando el parámetro profile en la solicitud

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

Consejos adicionales

• La migración requiere definición explícita de parámetros → no hay comportamiento implícito vía contexto.
• Revise siempre los esquemas de solicitud específicos de la API (Routing, Geocoding, Maps son diferentes).
• Este cambio mejora la claridad y mantenibilidad de las solicitudes.

Artículos relacionados

PTV Developer: Migrando de xServer a PTV Developer
Documentación de PTV Developer API