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

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

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

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

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

Вот несколько примеров запросов и ответов Photorealistic 3D Tiles. Вы можете проверить их с помощью Chrome Developer Tools.

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

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 фрагментов карты . Информация об атрибуции данных возвращается в каждом ответе фрагмента. Найдите ее в плитке 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 .