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