Cambiar el tipo de retorno de las coordenadas de la ruta
Para reducir el tamaño de la respuesta y aumentar el rendimiento, especialmente en rutas largas, puede utilizar el parámetro pointsMode
para cambiar la forma en que deben devolverse las coordenadas.
pointsMode
es un query param y debe añadirse al endpoint utilizado para buscar la solución de ruta.
Valores permitidos
object
Formato de coordenadas estándar en Trip asincrónica, si no se introduce el parámetro. Las coordenadas de la ruta serán como un objeto con dos claves, latitud y longitud, como en el siguiente ejemplo:
Trip sincrónica – https://api.maplink.global/trip/v2/calculations?pointsMode=object
Trip asincrónica – https://api.maplink.global/trip/v1/solutions/{tripId}?pointsMode=object
"legs": [ { "distance": 856, "nominalDuration": 44, "averageSpeed": 70.04, "points": [ { "latitude": -15.016381160108912, "longitude": -57.180606412016644 }, //....(Truncado).... { "latitude": -15.024091803051613, "longitude": -57.180970134787366 } ], } ]
array
Las coordenadas de la ruta se devolverán en formato de array, donde la primera posición se refiere a la latitud y la segunda a la longitud, como en el siguiente ejemplo:
Trip sincrónica – https://api.maplink.global/trip/v2/calculations?pointsMode=array
Trip asincrónica – https://api.maplink.global/trip/v1/solutions/{tripId}?pointsMode=array
"legs": [ { "distance": 856, "nominalDuration": 44, "averageSpeed": 70.04, "points": [ [ -12.83504, -38.42209 ], //....(Truncado).... [ -12.83475, -38.42198 ] ] } ],
geohash
Las coordenadas de la ruta se devolverán en formato de string representando la latitud y la longitud codificadas en geohash, como en el siguiente ejemplo:
Trip sincrónica – https://api.maplink.global/trip/v2/calculations?pointsMode=geohash
Trip asincrónica – https://api.maplink.global/trip/v1/solutions/{tripId}?pointsMode=geohash
"legs": [ { "distance": 856, "nominalDuration": 44, "averageSpeed": 70.04, "points": [ "6tr6df675", //....(Truncado).... "6tr6dbfn6" ] } ],
polyline
Formato de coordenadas estándar en Trip sincrónica, si no se introduce el parámetro. Las coordenadas de la ruta se codificarán todas en formato polyline, lo que reducirá considerablemente el tamaño de la respuesta y mejorará el rendimiento, como en el siguiente ejemplo:
Trip sincrónica – https://api.maplink.global/trip/v2/calculations?pointsMode=polyline
Trip asincrónica – https://api.maplink.global/trip/v1/solutions/{tripId}?pointsMode=polyline
"legs": [ { "distance": 4272, "nominalDuration": 315, "averageSpeed": 40.5, "points": "nxmmAv_thFLvADJ^`@HNN^BTCj@QbB@bAEV??gKeD_Cy@{@c@wDmBmPuIuX}NwEaC}IyEeVqMyc@_V??m@}@IUa@{CUeCWyD??t@k@tCmCzAiAFOAM{@}A??hB{ArAi@r@Q`AGREd@UZKxBi@|C}A??" } ],