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 procesador de tarjetas 3D. Este enfoque requiere que tengas en cuenta los siguientes factores importantes:

URLs de contenido

Cuando se entregan mosaicos 3D fotorrealistas, la API de Map Tiles muestra los URI de los conjuntos de mosaicos secundarios. Estos URIs de conjunto de mosaicos no son URLs normales, sino que solo incluyen el componente de ruta y parámetros. No contienen tu clave de API, que es necesaria para autorizar la 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 Photorealistic 3D Tiles. 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

Ejemplo de URI de respuesta del conjunto de mosaicos:

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

Ejemplos de URLs de solicitudes de mosaicos que usan los procesadores:

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

Cuando construyas las solicitudes de tarjetas posteriores, debes adjuntar cualquier parámetro que aparezca en el URI del conjunto de mosaicos, junto con tu clave de API. La API de 3D Tiles proporciona los siguientes dos parámetros:

session
Es un identificador integrado para una sesión de carga 3D. La API lo genera automáticamente. El procesador debe adjuntarla 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.

Atribuciones de Display

Atribución significa reconocer la fuente de los mosaicos de mapas y es un requisito para usar esta API, lo que incluye la atribución de 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úscalo en el cuerpo de la respuesta, en el archivo JSON, 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 sobre derechos de autor de todos los mosaicos a la vista.

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

  3. Ordena la información según el número de casos.

  4. Muestra las fuentes de derechos de autor en la pantalla, en orden descendente según la cantidad de casos, de manera similar a como lo hace Google Earth.