Domanda

Stai migrando da PTV xServer (XRoute, XLocate, XMap) a PTV Developer APIs e attualmente utilizzi un blocco callerContext come:

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

Vuoi capire come questi parametri debbano essere gestiti nelle nuove API.

Risposta

Il concetto di callerContext non esiste più nelle PTV Developer APIs.
Tutti i parametri devono ora essere definiti esplicitamente nel corpo della richiesta o nei parametri di query.

Mappatura dei Parametri

➤ CoordFormat

• Non è più richiesto
• Le coordinate sono gestite implicitamente usando WGS84 (latitudine/longitudine)

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

➤ ResponseGeometry

• Controllato tramite opzioni di richiesta (es. formato della geometria come polilinea)

Riferimenti: 

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

➤ Profile

• Specificato direttamente utilizzando il parametro profile nella richiesta

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

Suggerimenti aggiuntivi

• La migrazione richiede la definizione esplicita dei parametri → nessun comportamento implicito tramite il contesto.
• Rivedi sempre gli schemi di richiesta specifici per API (Routing, Geocoding, Maps differiscono).
• Questa modifica migliora la chiarezza e la manutenibilità delle richieste.

Articoli correlati

PTV Developer: Migrare da xServer a PTV Developer
Documentazione PTV Developer API