Resolver problemas com a API Geospatial

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Óculos XR com fio
Óculos com áudio e
tela

Se você estiver com problemas com a API Geospatial, confira algumas etapas comuns a serem seguidas.

A autorização da chave de API nunca é bem-sucedida

Se a autorização da chave de API não estiver funcionando, siga estas etapas:

  • Verifique se você ativou a API ARCore para o projeto correto no Google Cloud.
  • Se você tiver alguma restrição de chave de API ativada, desative-a temporariamente.
  • Use o APK Analyzer para verificar se a chave de API está incluída no build do app. Ele precisa estar em um elemento <meta-data> no elemento <application> no AndroidManifest.xml do app:

    <meta-data
      android:name="com.google.android.ar.API_KEY"
      android:value="API_KEY"/>
    
  • Verifique se a chave de API listada nas credenciais do seu projeto corresponde exatamente à chave de API usada pelo app, sem espaços ou outros caracteres.

A qualidade da localização geoespacial nunca atinge os valores esperados

Se a qualidade das poses retornadas pela API Geospatial não atingir os resultados esperados, confira algumas causas possíveis:

  • A área não foi mapeada por uma fonte oficial do Google Street View.
    • Para verificar, abra o Google Maps e entre no Street View perto da posição de localização esperada. A atribuição das imagens do Street View precisa ser Google Street View. Outras fontes não são consideradas para o VPS.
  • A área está em uma região restrita.
  • A área não tem pontos de recursos qualificados suficientes.
    • O VPS usa apenas pontos de recurso de alta qualidade que provavelmente não vão mudar por um longo período. Por exemplo, as árvores podem variar muito de aparência ao longo do ano, então não são adequadas para uso como pontos de recurso.
    • A área pode ter mudado significativamente devido a obras de infraestrutura em comparação com as capturas recentes do Google Street View.