Работайте с собственным рендерером 3D Tiles

Если вы не можете включить в свое решение сторонний продукт для рендеринга, возможно, вам придется создать собственный модуль рендеринга 3D-плиток. Этот подход требует рассмотрения следующих важных факторов:

URL-адреса контента

При предоставлении фотореалистичных 3D-листов API Map Tiles возвращает URI для дочерних наборов плиток. Эти URI набора плиток не являются обычными URL-адресами. Они включают только компонент пути и параметров. Они не содержат вашего ключа API, который необходим для авторизации вашего запроса. Для получения дополнительной информации см. Спецификацию 3D-плиток .

Запросы и ответы

Вот несколько примеров запросов и ответов на фотореалистичные 3D-плитки. Вы проверяете их с помощью инструментов разработчика Chrome.

Пример запроса корневого набора плиток:

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

Пример URI ответа набора плиток:

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

Примеры URL-адресов запроса плитки, используемых рендерерами:

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

Вам следует прикрепить любые параметры, которые появляются в URI набора плиток, вместе с вашим ключом API, когда вы создаете последующие запросы плиток. API 3D Tiles предоставляет следующие два параметра:

session
Встроенный идентификатор сеанса 3D-загрузки. Он автоматически генерируется API. Он должен быть прикреплен средством рендеринга при построении последующих запросов фрагментов.
key
Ключ API, который вы использовали для доступа к сервису 3D Tiles. Вы должны прикрепить его ко всем последующим запросам плиток.

Отображать атрибуцию

Атрибуция означает подтверждение источника фрагментов карты и является требованием для использования этого API. Сюда входит атрибуция бренда (логотипа) Google, а также атрибуция данных. Логотип Google доступен на странице «Политики API Map Tiles» . Информация об атрибуции данных возвращается в каждом ответе плитки. Найдите его в теле ответа в формате JSON в разделе asset.copyright .

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

Вы должны агрегировать, сортировать и отображать эту информацию в строке текста, обычно в нижней части изображения. Это влечет за собой следующие шаги:

  1. Извлеките всю информацию об авторских правах из всех видимых плиток.

  2. Разделяйте несколько источников авторских прав точкой с запятой.

  3. Отсортируйте информацию по количеству вхождений.

  4. Отображение источников авторских прав на экране, упорядоченных от большинства случаев к меньшему, аналогично тому, как это делает Google Earth .