Работайте с собственным рендерером 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-тайлов предоставляет следующие два параметра:

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

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

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