Как работать с собственным отрисовщиком 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 Планета Земля.