Solução de problemas

Erros

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

A resposta contém um objeto com um único objeto error com as seguintes chaves:

  • code: é igual ao status HTTP da resposta.
  • message: uma breve descrição do erro.
  • status: um código de status que indica a natureza do erro.

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

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

Possíveis erros incluem:

Código Status Envie 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. Verifique se você incluiu a chave inteira e se ativou a API para ela.
400 INVALID_ARGUMENT O parâmetro "\"path\" contém um valor inválido: aba Sua solicitação contém argumentos inválidos. As causas mais prováveis desse erro são as seguintes:
  • Um problema com o parâmetro path.
    Verifique se você tem entre 1 e 100 pontos. Cada ponto precisa ser um par de números separados por uma vírgula, como: 48.409114,-123.369158. Os pontos precisam ser separados por uma barra vertical: "|".
  • Sua solicitação incluía um valor de placeId inválido.
  • Sua solicitação incluiu placeIds 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 transmitido para uma estrada que não existe mais ou para um lugar que não é uma estrada.
403 PERMISSION_DENIED A solicitação não registrada foi bloqueada. Inscreva-se usando o Google Developers Console. A solicitação foi negada por um ou mais dos seguintes motivos:
  • A chave de API está ausente ou é inválida.
  • O faturamento não foi ativado em sua conta.
  • Um limite de uso definido pelo próprio usuário foi excedido.
  • A forma de pagamento fornecida não é mais válida (por exemplo, o cartão de crédito expirou).

Para usar os produtos da Plataforma Google Maps, o faturamento precisa estar ativado na sua conta, e todas as solicitações têm que incluir uma chave de API válida. Para corrigir isso, siga estas etapas:
404 NOT_FOUND O HTTPS é obrigatório para este serviço. Verifique se você está enviando solicitações para https://roads.googleapis.com/ e não para http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED A solicitação foi limitada porque os limites de solicitações do projeto foram atingidos. Você excedeu o limite de solicitações configurado no console do Google Cloud Platform. Normalmente, esse limite é definido como solicitações por dia, solicitações por 100 segundos e solicitações por 100 segundos por usuário. Configure esse limite para evitar que um único ou pequeno grupo de usuários esgote sua cota diária, ao mesmo tempo em que permite um acesso razoável a todos. Consulte Como limitar o uso da API para configurar esses limites.

Espera exponencial

Quando houver falha nas solicitações, tente fazer novas tentativas com espera 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 em grande escala não sobrecarreguem os servidores do Google, já que muitos clientes tentam repetir as solicitações muito rapidamente.

Perguntas frequentes sobre solução de problemas

Problemas de implementação

Com que frequência devo coletar amostras da localização do meu veículo?
A cada 10 segundos é recomendado para ter resultados de alta qualidade no alinhamento à via.
Existe um limite para o número de pontos que posso enviar por consulta?
Sim, uma consulta pode ter no máximo 100 pontos.
Que nível de precisão devo usar para armazenar meus pares de latitude/longitude ajustados?
Para garantir que os caminhos direcionados sigam as vias em todos os níveis de zoom, mesmo no máximo, armazene os pares de latitude/longitude ajustados em sete casas decimais de precisão.
Posso usar polilinhas codificadas para exibir caminhos direcionados?
As polilinhas codificadas são especificadas apenas com uma precisão de cinco casas decimais, o que resulta em um erro de aproximadamente dois metros. Portanto, as polilinhas codificadas não são adequadas se você quer que os caminhos direcionados sigam a via em níveis altos de zoom.

Problemas comuns

Alguns pontos não estão sendo ajustados ou tenho lacunas nos caminhos direcionados. Como posso corrigir isso?
  • Se você estiver fazendo amostragem dos pontos em intervalos cronometrados, faça isso em intervalos mais curtos (a cada 1 a 10 segundos). Se um intervalo mais longo for usado (por exemplo, 60 segundos), o algoritmo de Snap to Roads não vai conseguir determinar as vias percorridas com precisão suficiente.
  • Se você clicar manualmente em um mapa para criar pontos, é muito fácil criar caminhos com poucos pontos ou pontos esparsos que o algoritmo de ajuste não lida bem. O algoritmo de ajuste funciona melhor quando os pontos estão próximos. Confira a demonstração do alinhamento a vias ou use o Inspetor de vias para testar seus caminhos.
Por que meus caminhos direcionados ficam pontiagudos ou um pouco fora da via quando aumento o zoom?
  • Você está truncando a precisão dos pares de latitude/longitude ajustados antes de exibi-los? Armazenar pares de latitude/longitude ajustados com uma precisão de menos de sete casas decimais gera erros de precisão quando o caminho ajustado é exibido no mapa.
  • Você está usando polilinhas codificadas? As polilinhas codificadas truncam os pares de latitude/longitude para cinco casas decimais, o que gera um erro de vários metros, resultando em linhas irregulares ou ligeiramente fora da via em níveis altos de zoom.

Se nenhuma das opções acima for o caso, é possível que os blocos do mapa tenham sido atualizados recentemente, fazendo com que eles fiquem dessincronizados com o índice de vias usado para o ajuste. Se apenas algumas de suas consultas foram afetadas, essa provavelmente será a causa. Como o Google Maps é atualizado regularmente, isso pode acontecer de vez em quando e com mais frequência se você consultar regularmente os caminhos antigos em um mapa (por exemplo, caminhos que foram direcionados há várias semanas). Para otimizar a visualização, ajuste os caminhos antigos antes de mostrá-los no mapa para minimizar as inconsistências entre os blocos do mapa e o índice de vias usado para ajuste.

O que pode fazer com que o limite de velocidade da via X seja exibido incorretamente?
Os limites de velocidade têm várias origens que variam em precisão e cobertura. Se você encontrar um padrão, como limites de velocidade para um tipo de via específico ou uma área específica que esteja sempre errada, siga estas etapas para nos informar:
  1. Abra o Google Maps no seu computador desktop OU o app Google Maps para Android.
  2. Abra o menu lateral esquerdo.
  3. Selecione Enviar feedback. Observação: talvez seja necessário fazer login.
  4. Selecione Editar o mapa.
  5. Selecione o trecho de via que você quer editar.
  6. Selecione Próxima.
  7. No campo "Outro", indique que o limite de velocidade está errado para essa estrada.
  8. Selecione Enviar.
Também é possível informar outros problemas aqui, por exemplo, se a via tem o nome incorreto, foi desenhada incorretamente, está fechada ou é particular.
Por que meu caminho alinhado está cortando curvas em vez de seguir a estrada?
Para corrigir esse problema, verifique o seguinte:
  • Verifique se o parâmetro interpolate está definido como true.
  • Verifique se a amostragem dos pontos de dados originais está em intervalos próximos o suficiente (a cada 1 a 10 segundos).
Por que estou recebendo muitos trechos de via retornados no caminho alinhado para uma estrada sem mudanças de limite de velocidade?
Quando o parâmetro interpolate é definido como true, a consulta de alinhamento à via retorna uma polilinha que acompanha a estrada em curvas, curvas e rotatórias. No caso de curvas, vários trechos são retornados, mesmo que o limite de velocidade não mude, para criar uma polilinha que siga a geometria da via.