Плитки дорожной карты

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

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

Получить фрагменты дорожной карты можно, отправив HTTPS GET-запрос, как показано в следующем примере.

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 по-прежнему будет определять положение тайла слева направо, то есть в данном случае с севера на юг на карте.

Ориентация в нулевую сторону ориентация на 90 градусов
Ориентация в нулевую сторонуориентация на 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

Для получения информации о заголовках ответных сообщений см. раздел «Предварительная загрузка, кэширование или хранение контента» .