Esta página foi traduzida pela API Cloud Translation.

Solução de problemas

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: Um problema com o parâmetro `path`. Verifique se você tem pelo menos 1 e menos de 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 separadas por uma barra vertical: '\|'. Sua solicitação incluiu um `placeId` inválido. Sua solicitação incluiu `placeId`s e um `path`. Somente um desses parâmetros pode ser especificado para cada solicitação. Este 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 pelo Google Developers do Cloud.	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, uma o cartão de crédito expirou). 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: Gerar uma chave de API Ative o faturamento na sua conta. Ajuste o limite de uso para aumentar a cota diária, se aplicável.
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 dois 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 direcionados, 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 pontos 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.

. Você também pode informar outros problemas aqui (por exemplo, se a estrada tem o o nome está incorreto, o desenho está incorreto, está fechado ou é privado).

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 como true.
Verificar se os pontos de dados originais são amostrados em intervalos próximos o suficiente (a cada 1 a 10 segundos).

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 como true, 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.