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

Solucionar erros

Em caso de erros, um corpo de resposta de erro com formato padrão será retornado e o código de status HTTP será definido como um status de erro.

A resposta contém um objeto com um só objeto error, que inclui as chaves a seguir:

  • code: esse valor é o mesmo que o status HTTP da resposta.
  • message: uma breve descrição do erro.
  • status: um código de status indicando a natureza do erro.

Por exemplo, o envio de um parâmetro placeId inválido retorna o seguinte erro:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Possíveis erros incluem:

Código Status Mensagem Solução de problemas
400 INVALID_ARGUMENT A chave fornecida é inválida. Sua chave de API não é válida ou não foi incluída na solicitação. Não deixe de usar a chave inteira e ativar a API para a chave.
400 INVALID_ARGUMENT O parâmetro "\"path\" contém um valor inválido: ☃" Sua solicitação contém argumentos inválidos. As causas mais prováveis desse erro são:
  • Um problema com o parâmetro path.
    Verifique se você tem entre 1 e 100 pontos. Cada ponto deve ser um par de números separados por uma vírgula, como: 48.409114,-123.369158. Os pontos devem ser separados por uma barra vertical: '|'.
  • Sua solicitação inclui um placeId inválido.
  • Sua solicitação inclui um placeId e um path. Somente um desses parâmetros pode ser especificado para cada solicitação.

Esse erro não será retornado se um placeId for passado para uma estrada que não existe mais ou para um local que não é uma estrada.

403 PERMISSION_DENIED Uma solicitação não registrada foi bloqueada. Faça login usando o Console do Desenvolvedor do Google. Sua chave de API não é válida ou não foi incluída na solicitação. Não deixe de usar a chave inteira e ativar a API para a chave.
404 NOT_FOUND HTTPS é obrigatório para esse serviço. Envie solicitações para https://roads.googleapis.com/, não para http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED A solicitação foi limitada porque o limite de solicitações por segundo do projeto foi atingido. Você ultrapassou o limite requests por segundo por usuário configurado no API Console. Esse limite deve ser configurado para impedir que um usuário ou grupo de usuários esgote sua cota diária, mas ainda assim permitir acesso razoável a todos.
429 RESOURCE_EXHAUSTED A solicitação foi limitada porque o limite diário foi atingido. Você excedeu a cota diária do seu projeto.

Retirada exponencial

Quando as solicitações falham, você teve garantir que novas tentativas tenham uma retirada exponencial. Por exemplo, se uma solicitação falhar uma vez, tente novamente após um segundo. Se falhar de novo, tente novamente após dois segundos, depois quatro segundos e assim por diante. Isso garante que solicitações inválidas ou falhas gerais não sobrecarreguem os servidores do Google, pois muitos clientes repetem as tentativas muito rapidamente.

Enviar comentários sobre…

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