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-as 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.