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

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

URLs de contenido

Cuando se entregan mosaicos fotorrealistas en 3D, la API de Map Tiles muestra URIs para conjuntos de mosaicos secundarios. Estos URIs de mosaicos no son URLs normales. Solo incluyen la ruta de acceso y el componente de parámetros. No contienen tu clave de API, que es obligatoria para autorizar tu solicitud. Para obtener más información, consulta la Especificación de tarjetas 3D.

Solicitudes y respuestas

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

Ejemplo de solicitud de mosaico raíz:

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

URI de respuesta de conjunto de mosaicos de muestra:

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

Estas son algunas URLs de solicitud de mosaicos de muestra 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 todos los parámetros que aparecen en el URI del conjunto de mosaicos, junto con tu clave de API, cuando crees 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 construye las solicitudes de tarjetas posteriores.
key
La clave de API que usaste para acceder al servicio de 3D Tiles. Debes adjuntarlo a todas las solicitudes de tarjetas posteriores.

Cómo mostrar atribuciones

La atribución consiste en reconocer la fuente de las tarjetas del mapa y es un requisito para el uso de esta API, lo que 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 Políticas de la API de Map Tiles. La información de atribución de datos se muestra en cada respuesta de 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 todas las tarjetas en la vista.

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

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

  4. Muestra las fuentes de derechos de autor en pantalla, ordenadas de la más frecuente a la menos frecuente, de manera similar a como lo hace Google Earth.