Как работать с собственным отрисовщиком 3D-плиток

Разработчики из Европейской экономической зоны (ЕЭЗ)

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

URL контента

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

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

Ниже приведены примеры запросов и ответов для фотореалистичных 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. В 3D Tiles API есть два параметра:

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

Как показывать сведения об авторах

Атрибуция – это указание источника фрагментов карты. Она обязательна при использовании этого API и включает атрибуцию бренда Google (логотип), а также атрибуцию данных. Логотип Google можно скачать на странице Правила Map Tiles API. Информация об атрибуции данных возвращается в каждом ответе на запрос тайла. Найдите его в карточке glTF в разделе 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 Планета Земля.