Class Maps

Карты

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

Характеристики

Свойство Тип Описание
Direction Finder Direction Finder Enums
Static Map Static Map Enums

Методы

Метод Тип возвращаемого значения Краткое описание
decode Polyline(polyline) Number[] Декодирует закодированную полилинию обратно в массив точек.
encode Polyline(points) String Преобразует массив точек в строку.
new Direction Finder() Direction Finder Создает новый объект DirectionFinder.
new Elevation Sampler() Elevation Sampler Создает объект ElevationSampler.
new Geocoder() Geocoder Создает новый объект Geocoder.
new Static Map() Static Map Создает новый объект StaticMap.
reset Authentication Api Key() void Сбрасывает учетные данные аутентификации, чтобы использовать квоты по умолчанию.
set Authentication By Api Key(apiKey) void Позволяет использовать ключ API для аутентификации запросов с целью получения дополнительных квот.
set Authentication By Api Key(apiKey, signingKey) void Позволяет использовать ключ API и ключ подписи для аутентификации запросов с целью использования дополнительных квот в StaticMap.

Подробная документация

decodePolyline(polyline)

Декодирует закодированную полилинию обратно в массив точек.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

Параметры

Имя Тип Описание
polyline String Закодированная полилиния для декодирования.

Возвращаться

Number[] — массив пар координат широты и долготы (lat0, long0, lat1, long1, ...).

См. также

encodePolyline(points)

Преобразует массив точек в строку.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

Параметры

Имя Тип Описание
points Number[] Массив пар широта/долгота для кодирования.

Возвращаться

String — закодированная строка, представляющая эти точки.

См. также

newDirectionFinder()

Создает новый объект DirectionFinder.

Возвращаться

DirectionFinder — новый объект для определения направления.

newElevationSampler()

Создает объект ElevationSampler.

Возвращаться

ElevationSampler — новый объект для сбора данных о высоте местности.

newGeocoder()

Создает новый объект Geocoder.

Возвращаться

Geocoder — новый объект для создания геокодеров.

newStaticMap()

Создает новый объект StaticMap.

Возвращаться

StaticMap — новый статический картографический объект.

resetAuthenticationApiKey()

Сбрасывает учетные данные аутентификации, чтобы использовать квоты по умолчанию. Этот метод работает, если вы используете ключ API для аутентификации запросов. Этот метод можно использовать для возврата к квотам по умолчанию, если вы хотите использовать методы Maps без предоставления учетных данных аутентификации.

Maps.resetAuthenticationApiKey();

Броски

Error — если для аутентификации используется setAuthentication(clientId, signingKey) .

setAuthenticationByApiKey(apiKey)

Позволяет использовать ключ API для аутентификации запросов с целью получения дополнительных квот.

Этот метод используется для установки ключа API, который используется для аутентификации запросов. При вызове этого метода потребление квоты и выставление счетов осуществляются проекту Google Cloud, связанному с предоставленным ключом API, в соответствии с прайс-листом . Вы можете использовать методы Maps с квотами по умолчанию без предоставления учетных данных для аутентификации. Если вы используете StaticMap, используйте вместо этого метод setAuthenticationByApiKey(apiKey, signingKey) .

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Параметры

Имя Тип Описание
api Key String Ключ API, который можно получить в консоли Google Cloud, выполнив действия, описанные в кратком руководстве .

Броски

Error — если apiKey равен null или если setAuthentication(clientId, signingKey) уже используется для аутентификации.

setAuthenticationByApiKey(apiKey, signingKey)

Позволяет использовать ключ API и ключ подписи для аутентификации запросов с целью использования дополнительных квот в StaticMap. Хотя ключ signingKey необходим для запросов к API Static Map, этот метод также можно использовать для аутентификации других сервисов Maps. В таких случаях параметр signingKey игнорируется.

Этот метод используется для установки ключа API и ключа подписи, которые используются для аутентификации запросов. Ключ подписи необходим для StaticMap; он принимает небольшое количество запросов без подписи в целях тестирования, но они начинают завершаться с ошибкой, как только это количество достигает порогового значения в вашей рабочей среде. Более подробную информацию можно найти здесь .

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

Параметры

Имя Тип Описание
api Key String Ключ API, который можно получить в консоли Google Cloud, выполнив действия, описанные в кратком руководстве .
signing Key String Ключ для цифровой подписи, который можно получить в консоли Google Cloud, следуя инструкциям, описанным в руководстве по цифровой подписи . Он необходим для StaticMap и не требуется для других картографических сервисов.

Броски

Error — если apiKey равен null или если setAuthentication(clientId, signingKey) уже используется для аутентификации.

См. также

Устаревшие методы