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

Limites de velocidade

Observação: o serviço de limite de velocidade está disponível apenas para clientes da Google Maps APIs Premium Plan com uma licença de Asset Tracking.

A Google Maps Roads API retorna o limite de velocidade divulgado para um determinado segmento de estrada. Em caso de segmentos de estrada com limites de velocidade variáveis, o limite de velocidade padrão do segmento em questão é retornado.

A precisão dos dados de limites de velocidade retornados pela Google Maps Roads API não pode ser garantida. Esses dados não são fornecidos em tempo real e podem ser estimados, imprecisos, incompletos e/ou desatualizados. É possível informar imprecisões em nossos dados pelo serviço Google Map Maker.

Solicitações

Uma solicitação de limites de velocidade deve ser enviada via HTTPS, no seguinte formato:

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

Uso de parâmetros

Parâmetros obrigatórios

  • Um path ou um ou mais placeId.
    • path — o caminho a ser direcionado. O parâmetro path aceita 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: "|". Por exemplo: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId — o ID de local do segmento de estrada. Os IDs de local são retornados como resposta a solicitações de snapToRoads e nearestRoads. Você pode passar até 100 parâmetros placeId em cada solicitação.
  • 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.

Parâmetros opcionais

  • units — se os limites de velocidade devem ser retornados em quilômetros ou milhas por hora. Esse parâmetro pode ser definido como KPH ou MPH. O valor padrão é KPH.

Você pode solicitar dados de limite de velocidade usando um path ou uma série de placeId. No entanto, você só receberá uma resposta para cada placeId distinto na solicitação. placeId duplicados podem estar presentes quando há muitos pontos em uma distância curta.

Respostas

Os elementos a seguir podem estar presentes em uma resposta do speedLimits:

  • speedLimits — uma matriz de metadados de estrada. Cada elemento consiste nos seguintes campos:
    • placeId — um identificador exclusivo para um local. Todos os placeId retornados pela Google Maps Roads API corresponderão a segmentos de estrada.
    • speedLimit — o limite de velocidade para o segmento de estrada.
    • units — retorna KPH ou MPH.
  • snappedPoints — uma matriz de pontos direcionados. Essa matriz estará presente somente se a solicitação contiver um parâmetro path. 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 valor da solicitação deve corresponder a um valor direcionado na resposta. Esses valores são indexados a partir de 0, portanto, um ponto com um originalIndex de 4 será o valor direcionado do quinto par de latitude/longitude passado para o parâmetro path.
    • placeId — um identificador exclusivo para um local. Todos os placeId retornados pela Google Maps Roads API corresponderão a segmentos de estrada. O placeId pode ser passado em uma solicitação de limites de velocidade para determinar o limite de velocidade no segmento de via em questão.

Exemplo de solicitação

A solicitação a seguir determinará os limites de velocidade de um curto segmento de estrada em Canberra, Austrália.

Solicitação

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Resposta

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Enviar comentários sobre…

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