Vias mais próximas

O Roads API usa até 100 coordenadas independentes e retorna o segmento de via mais próximo para cada ponto. Os pontos transmitidos não precisam fazer parte de um caminho contínuo.

Se você estiver trabalhando com pontos de GPS sequenciais, use o Ajuste de trajeto.

Solicitações

Uma solicitação para estradas mais próximas precisa ser enviada usando HTTPS e tem o seguinte formato:

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

Parâmetros obrigatórios

pontos

Os pontos a serem ajustados. O parâmetro de pontos aceita uma lista de pares de latitude/longitude. Separe os valores de latitude e longitude com vírgulas. Separe as coordenadas com o caractere de barra vertical: "|". Por exemplo: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Exemplos

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

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Respostas

Para cada solicitação válida, a Roads API retorna uma resposta no formato indicado no URL da solicitação.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

A resposta usa o esquema a seguir.

NearestRoadsResponse

Campo Obrigatório Tipo Descrição
opcional Matriz<SnappedPoint>

Uma matriz de pontos ajustados. Às vezes, contém vários pontos ajustados para o mesmo ponto com placeId ou local diferente.

Consulte SnappedPoint para mais informações.

SnappedPoint

Campo Obrigatório Tipo Descrição
required LatitudeLongitudeLiteral Consulte LatitudeLongitudeLiteral para mais informações.
required string

Um identificador exclusivo de um lugar. Todos os IDs de lugar retornados pela API Roads correspondem a trechos de via.

opcional número

Um número inteiro que indica o valor correspondente na solicitação original. Cada valor na solicitação precisa ser mapeado para um valor ajustado na resposta. No entanto, se você tiver definido interpolate=true ou se estiver usando estradas mais próximas, é possível que a resposta contenha mais coordenadas do que a solicitação. Os valores interpolados não terão um originalIndex. Esses valores são indexados a partir de 0. Portanto, um ponto com um originalIndex de 4 será o valor ajustado da quinta latitude/longitude transmitida ao parâmetro de caminho. Os pontos da Nearest Roads podem conter vários pontos para coordenadas únicas com local ou placeId diferentes.

LatitudeLongitudeLiteral

Um objeto que descreve um local específico com latitude e longitude em graus decimais.

Campo Obrigatório Tipo Descrição
required número

Latitude em graus decimais
required número

Longitude em graus decimais