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.