Если вы не можете включить в свое решение сторонний продукт для рендеринга, возможно, вам придется создать собственный модуль рендеринга 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 Tiles предоставляет следующие два параметра:
-
session
- Встроенный идентификатор сеанса 3D-загрузки. Он автоматически генерируется API. Он должен быть прикреплен средством рендеринга при построении последующих запросов фрагментов.
-
key
- Ключ API, который вы использовали для доступа к сервису 3D Tiles. Вы должны прикрепить его ко всем последующим запросам плиток.
Показать атрибуцию
Атрибуция означает подтверждение источника фрагментов карты и является требованием для использования этого 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"
}
}
Вы должны агрегировать, сортировать и отображать эту информацию в строке текста, обычно в нижней части изображения. Это влечет за собой следующие шаги:
Извлеките всю информацию об авторских правах из всех видимых плиток.
Разделяйте несколько источников авторских прав точкой с запятой.
Отсортируйте информацию по количеству вхождений.
Отображение источников авторских прав на экране, упорядоченных от большинства случаев к меньшему, аналогично тому, как это делает Google Earth .