Se não for possível incorporar um produto de renderização de terceiros à sua solução, talvez seja necessário criar seu próprio renderizador de blocos 3D. Essa abordagem exige que você considere os seguintes fatores importantes:
URLs de conteúdo
Ao veicular blocos 3D fotorrealistas, a API Map Tiles retorna URIs para conjuntos de blocos filhos. Esses URIs de conjunto de blocos não são URLs comuns. Eles incluem apenas o componente de caminho e parâmetros. Elas não contêm sua chave de API, que é necessária para autorizar sua solicitação. Para mais informações, consulte a especificação de blocos 3D.
Solicitações e respostas
Confira alguns exemplos de solicitações e respostas de blocos fotorrealistas em 3D. Você pode inspecioná-los usando as Ferramentas para desenvolvedores do Chrome.
Exemplo de solicitação de conjunto de blocos raiz:
https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
Exemplo de URI de resposta do conjunto de blocos:
/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg
Exemplos de URLs de solicitação de bloco usados por renderizadores:
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY
Anexe todos os parâmetros que aparecem no URI do conjunto de blocos, junto com sua chave de API, ao construir as solicitações de blocos subsequentes. A API 3D Tiles fornece os dois parâmetros a seguir:
session
- Um identificador integrado para uma sessão de carregamento 3D. Ele é gerado automaticamente pela API. Ele precisa ser anexado pelo renderizador ao construir as solicitações de blocos subsequentes.
key
- A chave de API usada para acessar o serviço 3D Tiles. Você precisa anexá-lo a todas as solicitações de bloco subsequentes.
Atribuições de display
Atribuição significa reconhecer a origem dos blocos de mapa e é um requisito para o uso dessa API. Isso inclui a atribuição da marca Google (logotipo) e de dados. O logotipo do Google está disponível na página Políticas da API Map Tiles. As informações de atribuição de dados são retornadas em todas as respostas de bloco. Procure no bloco glTF, em asset
, copyright
.
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
É necessário agregar, classificar e mostrar essas informações em uma linha de texto, geralmente na parte de baixo da renderização. Isso envolve as seguintes etapas:
Extraia todas as informações de direitos autorais de todos os blocos em exibição.
Separe várias fontes de direitos autorais com um ponto e vírgula.
Ordene as informações com base no número de ocorrências.
Mostre as fontes de direitos autorais na tela, ordenadas da maior para a menor ocorrência, de maneira semelhante ao que o Google Earth faz.