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

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

Пример запроса плитки

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

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