Эта страница переведена с помощью Cloud Translation API.

Используйте токены сеанса с API плиток карты

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

Токен сессии — это фрагмент данных ( UUID ), используемый в REST-запросах для идентификации сессии — серии связанных обменов сообщениями. Необходимо включать токен сессии во все запросы на 2D-тайлы и изображения Street View. Он указывается в качестве значения параметра session , добавляемого ко всем URL-адресам запросов.

В API Map Tiles токен сессии представляет собой определенный набор параметров отображения. Это означает, что вам не нужно передавать набор параметров отображения с каждым запросом к тайлам. Вы можете использовать один и тот же токен сессии для нескольких клиентов. В настоящее время токен сессии действителен в течение двух недель с момента его выдачи, но это может измениться. Вы всегда можете проверить срок действия токена сессии, посмотрев поле expiry в ответном сообщении.

Запрос токена сессии

Для запроса токена сессии отправьте HTTPS POST-запрос на конечную точку createSession , как показано в следующем примере. Запрос необходимо отправить с заголовком Content-Type: application/json .

curl -X POST -d '{
  "mapType": "streetview",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

Обязательные поля

mapType

Тип базовой карты. Это значение может быть одним из следующих:

roadmap: Стандартные нарисованные фрагменты карты Google Maps.
satellite: Спутниковые снимки.
terrain: Изображения местности. При выборе типа карты terrain необходимо также указать тип слоя layerRoadmap (описано в разделе «Необязательные поля »).
streetview: Панорамные изображения Street View. Для получения дополнительной информации см. «Фрагменты Street View» .

language

Языковой тег IETF , указывающий язык, используемый для отображения информации на плитках. Например, en-US обозначает английский язык, на котором говорят в Соединенных Штатах.

region

Идентификатор региона Common Locale Data Repository (две заглавные буквы), представляющий физическое местоположение пользователя. Например, US .

Необязательные поля

imageFormat

Указывает формат возвращаемого файла. Допустимые значения: jpeg или png . Файлы JPEG не поддерживают прозрачность, поэтому их не рекомендуется использовать для наложения изображений. Если вы не укажете imageFormat , то наилучший формат для изображения будет выбран автоматически.

scale

Увеличивает размер элементов карты (например, обозначений дорог), сохраняя при этом размер и площадь покрытия стандартного тайла. Увеличение масштаба также уменьшает количество обозначений на карте, что снижает загромождение. Допустимые значения scale :

scaleFactor1x : Значение по умолчанию.
scaleFactor2x : Удваивает размер меток и удаляет метки второстепенных объектов.
scaleFactor4x : Увеличивает размер меток в четыре раза и удаляет метки второстепенных объектов.

Следующие примеры демонстрируют влияние масштабирования элементов карты.

Масштабный коэффициент 1x	Масштабный коэффициент 2x

highDpi: Указывает, следует ли возвращать тайлы высокого разрешения. Если коэффициент масштабирования увеличен, используется параметр highDpi для увеличения размера тайла. Обычно увеличение коэффициента масштабирования увеличивает результирующий тайл до изображения того же размера, что снижает качество. При использовании highDpi результирующий размер также увеличивается, сохраняя качество. DPI означает точки на дюйм, и High DPI означает, что тайл отображается с использованием большего количества точек на дюйм, чем обычно. Если true , то количество пикселей в каждом из измерений x и y умножается на коэффициент масштабирования (то есть 2x или 4x). Площадь покрытия тайла остается неизменной. Этот параметр работает только со значениями scale 2x или 4x. Он не влияет на тайлы с масштабом 1x.

Масштабный коэффициент 1x	Коэффициент масштабирования 2x, высокое разрешение (DPI)

layerTypes

Массив значений, определяющий типы слоев, добавленных на карту. Допустимые значения:

layerRoadmap: Обязательно, если в качестве типа карты указан terrain . Также может быть наложена поверх satellite карты. Не влияет на фрагменты дорожной карты.
layerStreetview: На карте синими контурами отображаются улицы и места, доступные в режиме Street View.
layerTraffic: Отображает текущую дорожную обстановку.

styles

Массив объектов JSON-стилей, определяющих внешний вид и уровень детализации таких элементов карты, как дороги, парки и застроенные территории. Стили используются для настройки стандартной базовой карты Google. Параметр styles действителен только в том случае, если тип карты — roadmap . Полный синтаксис стилей см. в Справочнике по стилям .

overlay

Логическое значение, указывающее, следует ли отображать layerTypes как отдельное наложение или объединять с базовым изображением. Если true , базовая карта не отображается. Если layerTypes не определены, это значение игнорируется.

Например, запрос карты типа satellite карта» со слоем layerRoadmap и overlay установленным в значение false приводит к получению тайлов, эквивалентных hybrid карте, используемой в JavaScript API карт (изображение слева). Та же карта и тип слоя с параметром overlay , установленным в true , приводят к получению прозрачного тайла с наложенной картой, соответствующим образом оформленной для наложения на спутниковые снимки (изображение справа).

`overlay` : false	`overlay` : true

Приведенный ниже JSON-код представляет собой пример типичного тела запроса, содержащего как обязательные, так и необязательные поля.

{
  "mapType": "satellite",
  "language": "en-US",
  "region": "us",
  "layerTypes": [ "layerRoadmap", "layerStreetview" ],
  "overlay":  true,
  "scale": "scaleFactor1x",
  "styles": [
    {
      "stylers": [
        { "hue": "#00ffe6" },
        { "saturation": -20 }
      ]
    },{
      "featureType": "road",
      "elementType": "geometry",
      "stylers": [
        { "lightness": 100 },
        { "visibility": "simplified" }
      ]
    }
  ]
}

В этом примере представлено наложение, подходящее для комбинирования со спутниковыми снимками. Пример содержит как карту дорог, так и панораму улиц. Полученная карта отображается с названиями и данными на английском языке, как он используется в Соединенных Штатах.

ответ с токеном сессии

Ниже приведён пример JSON-ответа.

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

Ниже приведён список определений полей в теле ответа.

session: Значение токена сессии, которое необходимо указывать во всех запросах к API Map Tiles.
expiry: Строка, содержащая время (в секундах с начала эпохи), по истечении которого срок действия токена истекает. Сессионный токен действителен в течение двух недель с момента его создания, но это правило может измениться без предварительного уведомления.
tileWidth: Ширина плиток измеряется в пикселях.
tileHeight: Высота плиток измеряется в пикселях.
imageFormat: Формат изображения может быть либо png , либо jpeg .