Cómo trabajar con tu propio procesador de tarjetas en 3D

Desarrolladores del Espacio Económico Europeo (EEE)

Si no puedes incorporar un producto de renderización de terceros en tu solución, es posible que debas crear tu propio renderizador de 3D Tiles. Este enfoque requiere que tengas en cuenta los siguientes factores importantes:

URLs de contenido

Cuando se publican Photorealistic 3D Tiles, la API de Map Tiles devuelve URIs para los conjuntos de mosaicos secundarios. Estos URI de conjunto de mosaicos no son URLs normales. Solo incluyen el componente de ruta de acceso y parámetros. No contienen tu clave de API, que es necesaria para autorizar tu solicitud. Para obtener más información, consulta la Especificación de 3D Tiles.

Solicitudes y respuestas

Estos son algunos ejemplos de solicitudes y respuestas de los mosaicos fotorrealistas en 3D. Puedes inspeccionarlos con las Herramientas para desarrolladores de Chrome.

Ejemplo de solicitud de conjunto de mosaicos raíz:

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

URI de respuesta del conjunto de mosaicos de muestra:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

Ejemplos de URLs de solicitudes de segmentos que usan los 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

Debes adjuntar los parámetros que aparecen en el URI del conjunto de mosaicos, junto con tu clave de API, cuando construyas las solicitudes de mosaicos posteriores. La API de 3D Tiles proporciona los siguientes dos parámetros:

session
Es un identificador integrado para una sesión de carga en 3D. La API lo genera automáticamente. El renderizador debe adjuntarlo cuando cree las solicitudes de segmentación posteriores.
key
Es la clave de API que usaste para acceder al servicio de 3D Tiles. Debes adjuntarlo a todas las solicitudes de segmentación posteriores.

Cómo mostrar las atribuciones

La atribución significa reconocer la fuente de los mosaicos de mapas y es un requisito para usar esta API. Esto incluye la atribución de la marca de Google (logotipo) y la atribución de datos. El logotipo de Google está disponible en la página de Políticas de la API de Map Tiles. La información de atribución de datos se devuelve en cada respuesta de la tarjeta. Búscala en la tarjeta de glTF, en asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

Debes agregar, ordenar y mostrar esta información en una línea de texto, por lo general, en la parte inferior de la renderización. Esto implica los siguientes pasos:

  1. Extrae toda la información de derechos de autor de todos los mosaicos visibles.

  2. Separa varias fuentes de derechos de autor con un punto y coma.

  3. Ordenar la información según la cantidad de ocurrencias

  4. Mostrar las fuentes de derechos de autor en la pantalla, ordenadas de la mayor a la menor cantidad de ocurrencias, de manera similar a como lo hace Google Earth