Trabalhar com seu próprio renderizador de blocos 3D

Desenvolvedores do Espaço Econômico Europeu (EEE)

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 conjuntos de blocos não são URLs normais. Eles incluem apenas o caminho e o componente de parâmetros. Eles não contêm a chave de API, que é necessária para autorizar a 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 3D fotorrealistas. 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

Exemplo de URLs de solicitação de blocos 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 a chave de API, ao criar 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 criar as solicitações de blocos subsequentes.
key
A chave de API que você usou para acessar o serviço de blocos 3D. É necessário anexá-la a todas as solicitações de blocos subsequentes.

Mostrar atribuições

A 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 a atribuição de dados. O logotipo do Google está disponível na página de políticas da API Map Tiles. As informações de atribuição de dados são retornadas em todas as respostas de blocos. 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:

  1. Extraia todas as informações de direitos autorais de todos os blocos em exibição.

  2. Separe várias fontes de direitos autorais com um ponto e vírgula.

  3. Classifique as informações com base no número de ocorrências.

  4. Mostre as fontes de direitos autorais na tela, ordenadas da maior para a menor ocorrência, de maneira semelhante ao Google Earth faz.