Фрагменты схемы – это фрагменты изображений, основанные на векторных топографических данных с картографическим стилем Google. включая дороги, здания, достопримечательности и политические границы.
Получение фрагментов дорожной карты
Получив токен сеанса, вы можете начать отправлять запросы тайлов дорожной карты. Поскольку токен сеанса применяется ко всему сеансу, вам не нужно указывать параметры карты в запросах фрагментов.
В приведенном ниже примере кода показан типичный запрос токена сеанса для фрагментов дорожной карты.
curl -X POST -d '{ "mapType": "roadmap", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Чтобы получить плитки дорожной карты, отправьте GET-запрос по протоколу HTTPS, как показано в следующем примере.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &orientation=0_or_90_or_180_or_270"
В этом GET-запросе HTTPS z – это уровень масштабирования (от 0 до 22), а x и y – координаты фрагмента, который вы хотите получить.
Параметр orientation необязателен. Значение указывает, на сколько градусов против часовой стрелки нужно повернуть изображение фрагмента. Параметр orientation поддерживается для фрагментов roadmap, а также для запросов спутниковых снимков и рельефа, в которых базовые изображения удалены с помощью параметра "overlay": true и задан параметр layerTypes. Допустимые значения orientation: 0 (по умолчанию), 90, 180 и 270.
Если вы добавите значение orientation, сетка координат фрагментов не будет повернута. Например, если задать для параметра orientation значение 90, то координата x по-прежнему будет определять положение фрагмента слева направо, что в данном случае соответствует направлению с севера на юг.
| Ориентация 0 градусов | Ориентация 90 градусов |
|---|---|
 |
 |
Пример запроса элемента
Рассмотрим следующий пример, в котором запрашивается один фрагмент, содержащий весь мир. В этом примере уровень масштабирования равен 0, а координаты x и y – 0, 0.
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
В этом примере нет ответного сообщения от сервера. Вместо этого фрагмент скачивается в локальный файл со следующей статистикой:
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
Информацию о заголовках ответных сообщений можно найти в разделе Упреждающий запрос, кеширование и хранение контента.