Erros
Em caso de erro, será retornado um corpo de resposta de erro com formato padrão 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 o seguinte
chaves:
code
: é o mesmo que o 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" } }
Os possíveis erros são:
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. Verifique se você incluiu a chave inteira e se ativou a API para essa chave. |
400 | INVALID_ARGUMENT |
“\"caminho\" O parâmetro contém um valor inválido: esperado. | Sua solicitação continha argumentos inválidos. As causas mais prováveis de
erro são:
Este erro não será retornado se um |
403 | PERMISSION_DENIED |
A solicitação não registrada foi bloqueada. Inscreva-se pelo Google Developers do Cloud. | A solicitação foi negada por um ou mais dos seguintes motivos:
Para usar os produtos da Plataforma Google Maps, o faturamento precisa estar ativado em sua conta, e todas as solicitações devem incluir uma chave de API válida. Para corrigir isso, siga estas etapas:
|
404 | NOT_FOUND |
O HTTPS é necessário para este serviço. | Verifique se você está enviando solicitações para
https://roads.googleapis.com/ e não
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 na Console do Google Cloud Platform. Esse limite normalmente é definido como solicitações por dia, solicitações por 100 segundos e solicitações por 100 segundos por usuário. Esse limite deve ser configurado para evitar que um único ou pequeno grupo de que seus usuários esgotem sua cota diária, permitindo um valor a todos os usuários. Consulte Como limitar o uso da API para configurar esses limites. |
Espera exponencial
Quando as solicitações falharem, você deverá tentar novamente solicitações com espera. Por exemplo, se uma solicitação falhar uma vez, tente novamente após um segundo, se ela falhar de novo, tentar 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, já que muitos clientes tentam repetir solicitações muito rapidamente.
Perguntas frequentes sobre solução de problemas
Problemas de implementação
- Com que frequência devo coletar amostras do local do meu veículo?
- Recomendamos esse tempo de 1 a 10 segundos para resultados de alta qualidade na velocidade com a rua.
- 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 minha latitude/longitude capturada? pares?
- Para que os caminhos certos sigam as vias em todos os níveis de zoom, nível de zoom máximo, armazene seus pares de latitude/longitude 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 2 metros. Assim, as polilinhas codificadas são não é adequado se você quer que os caminhos ajustados sigam a estrada em alto zoom níveis
Problemas comuns
- Alguns pontos não estão sendo definidos ou há lacunas nos caminhos de ajustes. Como Corrigi isso?
-
- Se você estiver fazendo a amostragem dos pontos em intervalos cronometrados, verifique se eles estão amostrados em intervalos mais curtos (a cada 1 a 10 segundos). Se um intervalo maior for usado (por exemplo, 60 segundos), o algoritmo de alinhamento à rua pode não conseguir determinar as estradas percorridas com precisão suficiente.
- Se você estiver clicando manualmente em um mapa para criar pontos, é muito fácil cria caminhos com poucos pontos ou esparsos que o algoritmo de ajuste não funciona bem. O algoritmo de ajuste funciona melhor para pontos que estão muito próximas. Experimente a função Ajustar a Demonstração de vias ou use o recurso Estradas inspetor para testar os caminhos.
- Por que meus caminhos certos estão irregulares ou um pouco fora da estrada quando eu 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 baseados em precisão menor do que 7 casas decimais causa erros de precisão quando o o caminho ajustado aparece no mapa.
- Você está usando polilinhas codificadas? Polilinhas codificadas são truncadas de latitude/longitude para cinco casas decimais, o que introduz um erro de vários metros, resultando em linhas irregulares ou ligeiramente fora da da estrada com altos níveis de zoom.
Se nenhuma das opções acima se aplicar, é possível que os blocos do mapa tenham sido atualizados recentemente, o que fez com que eles ficassem dessincronizados com o índice de vias usado para ajuste. Se apenas algumas de suas consultas forem afetadas, esta pode ser a causa. Como o Google Maps é atualizado regularmente, isso pode acontecer ocasionalmente, e podem ocorrer com mais frequência se você analisar regularmente os caminhos antigos em um mapa (por por exemplo, caminhos que foram capturados há várias semanas). Para uma visualização ideal, você deve ajustar novamente os caminhos antigos antes de mostrá-los em um mapa, para minimizar as inconsistências entre os blocos de mapas e o índice de estradas usado para ajuste.
- O que pode fazer com que o limite de velocidade da via X seja mostrado 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
em uma área específica estarem errados, siga estas etapas
para nos informar:
- Abra o Google Maps em um computador desktop OU o aplicativo do Google Maps para Android
- Abra o menu lateral esquerdo.
- Selecione Enviar feedback. Observação: pode ser necessário fazer login.
- Selecione Editar o mapa.
- Selecione o trecho da via que você quer editar.
- Selecione Próxima.
- Na caixa "Outros", , indique que o limite de velocidade está errado para aquela estrada.
- Selecione Enviar.
- Por que meu caminho encurtado está cortando cantos em vez de seguir a estrada?
-
Para corrigir esse problema, verifique o seguinte:
- Verifique se o parâmetro
interpolate
está definido comotrue
. - Verificar se os pontos de dados originais são amostrados em intervalos próximos o suficiente (a cada 1 a 10 segundos).
- Verifique se o parâmetro
- Por que estou recebendo vários trechos de via no caminho direcionado para um em uma via sem limite de velocidade?
- Quando o parâmetro
interpolate
é definido comotrue
, a consulta de alinhamento à rua retorna uma polilinha que segue a estrada ao redor das curvas, curvas e rotatórias. Se as curvas da estrada forem, vários trechos de via retornado mesmo que o limite de velocidade não seja alterado, a fim de criar uma polilinha que segue de perto a geometria da estrada.