Atualizando status do pedido e coordenadas do entregador
Atualizando o status do pedido
Para alterar o status do pedido, é preciso realizar a requisição para a API usando método POST para o seguinte endpoint:
https://api.maplink.global/tracking/v1/orders/{{trackingId}}/status
Onde o termo {{trackingId}}
deve ser substituído pelo ID do pedido a ser atualizado.
Um exemplo de requisição pode ser conferido abaixo:
{ "value": "ON_THE_WAY", "label": "Em trânsito" }
Onde:
value
– Valores
possíveis: ["PREPARING", "ON_THE_WAY", "DONE", "NOT_DONE", "CANCELLED"
].label
– Texto personalizado para ser exibido na página de rastreio.
Atualizando as coordenadas do entregador
Para atualizar as coordenadas, é preciso realizar a requisição para a API usando método POST para o seguinte endpoint:
https://api.maplink.global/tracking/v1/orders/{{trackingId}}/driver
Onde o termo {{trackingId}}
deve ser substituído pelo ID do pedido a ser atualizado.
As atualizações das coordenadas na página de rastreamento acontecem a cada 15 segundos.
Atualizações enviadas em um período menor do que 15 segundos não serão refletidas na página de rastreio.
Um exemplo de requisição pode ser conferido abaixo:
{ "name": "Maplink BR", "image": "https://example.com", "currentLocation": { "lat": -22.72725697031394, "lon": -47.636846753567944 } }
Onde:
name
– (Opcional) Nome do motoristaimage
– (Opcional) URL da foto do motorista para ser exibida no sitecurrentLocation
– Objeto com as coordenadas atuais do motorista.lat
– Coordenada da latitude em graus decimais.lon
– Coordenada da longitude em graus decimais.