---
title: Quais são os parâmetros da Distance Matrix API?
description: Conheça todos os parâmetros disponíveis na Distance Matrix API, com descrição e exemplos práticos.
---

[Pular para o conteúdo](https://knowledge.maplink.global/migration/pt-br/base/quais-são-os-parâmetros-da-distance-matrix-api#main-content)

Português - Brasil

Mostrar submenu para traduções

[Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new?hsLang=pt-br) [Portal do cliente](https://knowledge.maplink.global/customers?hsLang=pt-br)

![logo\_maplink-1.png\]](https://knowledge.maplink.global/hs-fs/hubfs/logo_maplink-1.png?height=40&name=logo_maplink-1.png)

Abrir navegação principal

Fechar navegação principal

- Português - Brasil
  
  Mostrar submenu para traduções
- [Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new)
- [Portal do cliente](https://knowledge.maplink.global/customers)
- Ir para maplink.global

 Ir para maplink.global

 Olá. Como podemos ajudá-lo?

- Não há sugestões porque o campo de pesquisa está em branco.

1. [Centro de ajuda](https://knowledge.maplink.global/migration/pt-br/base?hsLang=pt-br)
2. [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br)
3. [Distance Matrix API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#distance-matrix-api)

# Quais são os parâmetros da Distance Matrix API?

## Conheça todos os parâmetros disponíveis na Distance Matrix API, com descrição e exemplos práticos.

Os seguintes parâmetros são obrigatórios para utilizar a Distance Matrix API:

- **calculationMode** - Indica o modo de cálculo para a rota. Suporta os tipos:
  
    - **THE\_FASTEST** - Considera o caminho mais rápido.
    - **THE\_SHORTEST** - Considera o caminho com menor quilometragem.
- **destinations** - Descrição dos pontos de destino com:
  
    - **siteId** - Identificador do ponto de parada.
    - **latitude** - Coordenada da latitude em graus decimais.
    - **longitude** - Coordenada da longitude em graus decimais.
- **origins** - Descrição dos pontos de origem com:
  
    - **siteId** - Identificador do ponto de parada.
    - **latitude** - Coordenada da latitude em graus decimais.
    - **longitude** - Coordenada da longitude em graus decimais.
- **tripProfile** - Identificador do perfil para realizar a rota. Recomendável utilizar sempre o “**MAPLINK**”, pois ele contém os mapas mais atualizados.

Exemplo com os parâmetros obrigatórios:

```
{    "calculationMode": "THE_FASTEST",    "destinations": [        {            "latitude": -23.561402303338195,             "longitude": -46.63862145421187,            "siteId": "destination1Liberdade"        }    ],    "origins": [        {            "latitude": -23.55363650451996,            "longitude": -46.620810158377516,            "siteId": "origin1Mooca"        }    ],    "tripProfile": "MAPLINK"}
```

Os seguintes parâmetros são opcionais:

- **avoidanceTypes** - Indica que a rota deverá determinados tipos de elementos do sistema viário. Valores permitidos são: **\[TUNNELS, BRIDGES, FERRIES, TOLL\_ROADS, TOLL\_GATES**\].
- **callback** - Contém os dados do *callback* que é uma URL de *webhook* para receber os eventos do cálculo do problema. Útil para evitar o consumo de créditos com a API de feedback para checar os eventos, visto que o callback irá enviar o status do processamento. Os argumentos possíveis são:
  
    - **url** - URL com o endereço que irá receber o *callback*.
    - **user** - Texto com o nome do usuário caso o *endpoint* precisar de autenticação*.*
    - **password** - Texto com a senha caso o *endpoint* precisar de autenticação.
- **restrictionZones** - Array com o texto do nome da área de restrição previamente cadastradas na Restriction Zone API.

Abaixo um exemplo com todos os parâmetros opcionais:

```
{    "avoidanceTypes": [        "TUNNELS",        "BRIDGES",        "FERRIES",        "TOLL_ROADS",        "TOLL_GATES"    ],    "calculationMode": "THE_FASTEST",    "destinations": [        {            "latitude": -23.682211,            "longitude": -46.546867,            "siteId": "SantoAndre"        }    ],    "origins": [        {            "latitude": -23.337132,            "longitude": -46.835427,            "siteId": "Cajamar"        }    ],    "restrictionZones": [],    "tripProfile": "MAPLINK"}
```

 

- [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#main-content)

    - [Planning API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#planning-api)
    - [Trip API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#trip-api)
    - [Toll API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-api)
    - [Toll for Maps API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-for-maps-api)
    - [Distance Matrix API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#distance-matrix-api)
    - [CO2 API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#co2-api)
    - [Restriction Zone API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#restriction-zone-api)
    - [Geocode API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#geocode-api)
    - [Freight API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#freight-api)
    - [Tracking API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#tracking-api)
- [APIs Google Maps Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-google-maps-platform?hsLang=pt-br)
- [Webinar e Workshop](https://knowledge.maplink.global/migration/pt-br/base/webinar-e-workshop?hsLang=pt-br)

[![](https://knowledge.maplink.global/hs-fs/hubfs/logo-maplink-novo-horizontal-colorido%20PNG.png?width=2190&height=540&name=logo-maplink-novo-horizontal-colorido%20PNG.png)](http://maplink.global)

Centro de ajuda maplink.global

Copyright © 2026, Maplink Cloud