11.3. Atualizando status 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 {{trackingId}}
é o ID do pedido.
Abaixo um exemplo de requisição para atualizar o status do pedido:
{
"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 {{trackingId}}
é o ID do pedido.
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.
Abaixo um exemplo de requisição para atualizar os dados e as coordenadas da posição atual do entregador:
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.