Фрагменты дорожной карты

Разработчики из Европейской экономической зоны (ЕЭЗ)

Обзор карточки "Дорожная карта"Фрагменты схемы – это фрагменты изображений, основанные на векторных топографических данных с картографическим стилем 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 градусов Поворот на 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

Информацию о заголовках ответных сообщений можно найти в разделе Упреждающий запрос, кеширование и хранение контента.