Alterar tipo de retorno das coordenadas da rota
Para diminuir o tamanho da resposta e aumentar a performance, principalmente em rotas mais longas, é possível utilizar o parâmetro pointsMode para alterar como as coordenadas devem ser retornadas.
O pointsMode é um query param e deve ser adicionado ao endpoint usado para buscar a solução da rota.
Valores permitidos
object
Formato de coordenadas padrão na Trip Assíncrona, caso o parâmetro não seja informado. As coordenadas da rota serão como um objeto possuindo duas chaves, latitude e longitude, como no exemplo a seguir:
Trip Síncrona – https://api.maplink.global/trip/v2/calculations?pointsMode=object
Trip Assíncrona – 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
As coordenadas da rota serão retornadas no formato array, onde a primeira posição se refere à latitude e a segunda posição se refere à longitude, como no exemplo a seguir:
Trip Síncrona – https://api.maplink.global/trip/v2/calculations?pointsMode=array
Trip Assíncrona – 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
As coordenadas da rota serão retornadas no formato string representando a latitude e longitude encodadas em geohash, como no exemplo a seguir:
Trip Síncrona – https://api.maplink.global/trip/v2/calculations?pointsMode=geohash
Trip Assíncrona – 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 padrão Trip Síncrona, caso o parâmetro não seja informado. As coordenadas da rota serão todas codificadas no formato polyline, diminuindo consideravelmente o tamanho da resposta e melhorando a performance, como no exemplo a seguir:
Trip Síncrona – https://api.maplink.global/trip/v2/calculations?pointsMode=polyline
Trip Assíncrona – 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??"
}
],
