Solução de problemas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Erros

No caso de um erro, um corpo de resposta de erro de 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 único objeto error com as seguintes chaves:

  • code: é o mesmo 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:

Programar Status A 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: StreetView" Sua solicitação contém argumentos inválidos. As causas mais prováveis desse erro são:
  • Ocorreu um problema com o parâmetro path.
    É preciso ter no mínimo 1 e no máximo 100 pontos. Cada ponto precisa ser um par de números separados por vírgula, como: 48.409114,-123.369158. Os pontos precisam ser separados por uma barra vertical: "|".
  • Sua solicitação incluiu um 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 vai ser retornado se um placeId for transmitido para uma via que não existe mais ou para um lugar que não é uma via.

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 destes motivos:
  • A chave de API está ausente ou é inválida.
  • O faturamento não foi ativado na sua conta.
  • O limite de uso definido pelo usuário foi excedido.
  • A forma de pagamento informada 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 precisam 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. Esse limite normalmente é definido como solicitações por dia, solicitações a cada 100 segundos e solicitações a cada 100 segundos por usuário. Esse limite precisa ser configurado para evitar que um único ou pequeno grupo de usuários esgote sua cota diária, mas ainda assim permitir um acesso razoável a todos os usuários. Consulte Como limitar o uso da API para configurar esses limites.

Espera exponencial

Quando as solicitações falham, repita as solicitações com espera exponencial. Por exemplo, se uma solicitação falhar uma vez, tente novamente após um segundo. Se falhar novamente, tente após dois segundos, depois quatro segundos e assim por diante. Isso garante que solicitações corrompidas 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 fazer a amostragem da localização do meu veículo?
A cada 1 a 10 segundos, recomenda-se resultados de alta qualidade de alinhamento.
Há um limite de pontos que posso enviar por consulta?
Sim, uma consulta pode ter no máximo 100 pontos.
Qual nível de precisão preciso usar para armazenar meus pares de latitude/longitude ajustados?
Para garantir que os caminhos ajustados sigam as vias em todos os níveis de zoom, mesmo no nível máximo de zoom, armazene seus 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 com precisão de cinco casas decimais, o que resulta em um erro de aproximadamente dois metros. Portanto, as polilinhas codificadas não serão adequadas se você quiser que os caminhos ajustados sigam a via em níveis altos de zoom.

Problemas comuns

Alguns pontos não estão sendo direcionados ou há lacunas nos caminhos ajustados. Como posso corrigir isso?
  • Se você fizer a amostragem dos pontos em intervalos cronometrados, faça a amostragem dos pontos em intervalos mais curtos (a cada 1 a 10 segundos). Se um intervalo mais longo for usado (por exemplo, 60 segundos), o algoritmo de aderência à estrada pode não ser capaz de determinar as vias percorridas com precisão suficiente.
  • Se você clica 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 processa bem. O algoritmo de ajuste funciona melhor quando há pontos próximos. Use a demonstração do Snap to Roads ou use o inspetor de vias para testar os caminhos.
Por que meus caminhos ajustados estão irregulares ou um pouco fora da via ao aumentar o zoom?
  • Você está truncando a precisão dos pares de latitude/longitude ajustados antes de exibi-los? O armazenamento de pares de latitude/longitude ajustados com 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 pares de latitude/longitude em cinco casas decimais, o que gera um erro de vários metros, resultando em linhas retas ou ligeiramente fora da estrada em níveis altos de zoom.

Se nenhuma das opções acima for o caso, os blocos do mapa podem ter sido atualizados recentemente, fazendo com que eles fiquem fora de sincronia com o índice de vias usado para o ajuste. Se apenas algumas consultas forem afetadas, essa provavelmente será a causa. Como o Google Maps é atualizado com frequência, isso pode acontecer às vezes e pode ocorrer com mais frequência se você analisa regularmente caminhos antigos em um mapa (por exemplo, caminhos que foram ajustados há várias semanas). Para uma visualização ideal, atualize novamente os caminhos antigos antes de exibi-los em um mapa, para minimizar as inconsistências entre os blocos do mapa e o índice de vias usado para o alinhamento.

O que pode fazer com que o limite de velocidade da via X seja exibido incorretamente?
Os limites de velocidade vêm de várias fontes que variam em precisão e cobertura. Se você encontrar um padrão, por exemplo, limites de velocidade para um tipo específico de via ou que uma área específica é consistentemente incorreta, siga estas etapas para nos informar:
  1. Abra o Google Maps no computador OU o app Google Maps para Android.
  2. Abra o menu lateral à esquerda.
  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 ela.
  8. Selecione Enviar.
Você também pode informar outros problemas aqui, por exemplo, se a via tiver o nome incorreto, for desenhada incorretamente, se for fechada ou particular.
Por que o meu caminho tirado corta 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 os pontos de dados originais são coletados em intervalos próximos o suficiente a cada 1 a 10 segundos.
Por que estou recebendo muitos trechos de via retornados no caminho direcionado sem mudanças no limite de velocidade?
Quando o parâmetro interpolate é definido como true, a consulta de ajuste à via retorna uma polilinha que segue a estrada ao redor dos cantos, curvas e rotatórias. Se as curvas forem curvas, vários trechos serão retornados, mesmo que o limite de velocidade não mude, para criar uma polilinha que acompanhe a geometria da estrada.