Tracking

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 motorista
  • image – (Opcional) URL da foto do motorista para ser exibida no site
  • currentLocation – Objeto com as coordenadas atuais do motorista.
    • lat – Coordenada da latitude em graus decimais.
    • lon – Coordenada da longitude em graus decimais.