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 tarjetas 3D. Esta requiere que consideres los siguientes factores importantes:

URLs de contenido

Al entregar mosaicos fotorrealistas en 3D, la API de Map Tiles muestra URI para conjuntos de mosaicos secundarios. Estos URI del conjunto de mosaicos no son URLs normales. Solo incluyen el componente de ruta y parámetros. No contienen tu clave de API, que es necesario para autorizar tu solicitud. Para obtener más información, consulta la Especificación de los mosaicos 3D.

Solicitudes y respuestas

Estos son algunos ejemplos de solicitudes y respuestas de Photorealistic 3D Tiles. Tú y las inspeccione 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

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 cualquier parámetro que aparezca 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 dos parámetros siguientes:

session
Es un identificador integrado para una sesión de carga en 3D. Se genera automáticamente por la API. El renderizador debe adjuntarlo cuando se construye el posterior solicitudes de tarjetas.
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 implica reconocer el origen de los mosaicos de mapas y es un requisito para uso de esta API, esto incluye la atribución de marca de Google (logotipo), así como 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 muestra en cada respuesta de tarjeta. Búscalo en la cuerpo de 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 la cantidad de repeticiones.

  4. Muestra las fuentes de derechos de autor en pantalla, ordenadas desde la mayoría de las veces hasta el por lo menos, similar a la forma Google Earth lo hace.