Trip

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??"
        }
],