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

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

Примечание: Координаты плитки не совпадают с географическими координатами. Для получения дополнительной информации о координатах плитки см. Карта и координаты плитки в документации Maps JavaScript API.

Параметр orientation является необязательным. Его значение указывает количество градусов поворота против часовой стрелки изображения плитки. orientation поддерживается для плиток roadmap , а также для запросов спутников и рельефа с удаленными базовыми изображениями с помощью "overlay": true и с установленным layerTypes . Допустимые значения orientation : 0 (по умолчанию), 90, 180 и 270.

Координатная сетка плитки не поворачивается, если вы включаете значение orientation . Например, если вы устанавливаете orientation на 90, то координата x по-прежнему определяет положение плитки слева направо, что в данном случае соответствует направлению с севера на юг на карте.

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

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