Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps Roads API

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps Roads API
  3. Criar chaves apropriadas
Continuar

Vias mais próximas

A Google Maps Roads API usa até 100 coordenadas independentes e retorna o segmento de estrada mais próximo para cada ponto. Os pontos passados não precisam ser parte de um caminho contínuo.

Se você está trabalhando com pontos sequenciais de GPS, use Snap to Roads.

Solicitações

Uma solicitação a estradas mais próximas deve ser enviada via HTTPS no seguinte formato:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Uso de parâmetros

Parâmetros obrigatórios

  • points — Uma lista de pares de latitude/longitude. Os valores de latitude e longitude devem ser separados por vírgulas. As coordenadas devem ser separadas pelo caractere de barra vertical: "|". For example:points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
  • key — a chave de API do aplicativo. Seu aplicativo deve ser identificado sempre que enviar uma solicitação para a Google Maps Roads API incluindo uma chave de API em cada solicitação. Saiba como obter uma chave.

Respostas

Para cada solicitação válida, a Google Maps Roads API retorna uma resposta no formato indicado pelo URL de solicitação. Os elementos a seguir podem estar presentes em uma resposta do recurso Snap to Roads.

  • snappedPoints — uma matriz de pontos direcionados. Cada ponto consiste nos seguintes campos:
    • location — contém um valor de latitude e de longitude.
    • originalIndex — um número inteiro que indica o valor correspondente na solicitação original. Cada ponto na solicitação mapeia para no máximo dois segmentos na resposta:
      • Se não há estradas próximas, nenhum segmento é retornado.
      • Se a estrada mais próxima é unidirecional, um segmento é retornado.
      • Se a estrada mais próxima é bidirecional, dois segmentos são retornados.
    • placeId — um identificador exclusivo para um local. Todos os IDs de local retornados pela Google Maps Roads API correspondem a segmentos de estrada. [IDs de local] podem ser usados por outras APIs do Google, incluindo a Google Places API e a Google Maps JavaScript API. Por exemplo, se precisar obter os nomes das estradas dos pontos direcionados retornados pela Google Maps Roads API, você pode passar o placeId para a Google Places API ou para a Google Maps Geocoding API. Na Google Maps Roads API, você pode passar o placeId em uma solicitação de limites de velocidade para determinar o limite de velocidade no segmento de estrada em questão.

Exemplo de solicitação

A solicitação a seguir retorna um conjunto de segmentos de estrada com base na lista especificada de coordenadas.

Solicitação

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

Resposta

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

Enviar comentários sobre…

Google Maps Roads API
Google Maps Roads API
Precisa de ajuda? Acesse nossa página de suporte.