Если вы не можете интегрировать сторонний продукт для рендеринга в своё решение, возможно, вам придётся создать собственный рендерер 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 Tiles. Его необходимо прикреплять ко всем последующим запросам на тайлы.
Отображение атрибуции
Атрибуция подразумевает указание источника фрагментов карты и является обязательным условием для использования этого API. Это включает в себя указание бренда Google (логотипа), а также указание авторства данных. Логотип Google доступен на странице «Политики API фрагментов карты» . Информация об атрибуции данных возвращается в каждом ответе на запрос фрагмента. Найдите её в файле glTF tile в разделе asset и copyright .
{
"asset": {
"version": "2.0",
"generator": "draco_decoder",
"copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
}
}
Эту информацию необходимо агрегировать, сортировать и отображать в строке текста, обычно в нижней части рендера. Это включает в себя следующие шаги:
Извлечь всю информацию об авторских правах из всех отображаемых плиток.
Разделяйте несколько источников авторских прав точкой с запятой.
Сортируйте информацию по количеству появлений.
Отобразите на экране источники авторских прав, упорядоченные от наибольшего количества упоминаний к наименьшему, подобно тому, как это делает Google Earth .