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

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

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

В этом HTTPS-запросе GET 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

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