Google Maps
Геокодирование, маршруты, места и расчет расстояний
Google Maps — это комплексная платформа, предлагающая широкий спектр API для картографии, геокодирования, маршрутизации, мест, данных об окружающей среде и многого другого. С помощью AACFlow ваши агенты могут использовать ключевые API Google Maps Platform для автоматизации различных рабочих процессов, связанных с местоположением.
В эту интеграцию включены следующие API Google Maps:
- Geocoding API: Преобразование адресов в координаты широты/долготы и обратное геокодирование.
- Directions API: Расчет маршрутов и направлений для автомобиля, пешком, на велосипеде или общественном транспорте между местоположениями.
- Distance Matrix API: Вычисление расстояний и времени в пути для нескольких комбинаций точек отправления и назначения.
- Places API: Поиск мест (бизнесов, достопримечательностей, заведений) по названию, типу или близости.
- Place Details API: Получение подробной информации о конкретном месте, такой как адрес, рейтинги, часы работы и контактные данные.
- Elevation API: Получение данных о высоте (высота над уровнем моря) для любого набора местоположений по всему миру.
- Time Zone API: Получение информации о часовом поясе для любого географического местоположения.
- Air Quality API: Получение данных о качестве воздуха в реальном времени для конкретных координат.
С помощью этих API ваши агенты AACFlow могут автоматизировать поиск и обогащение местоположений, планировать оптимальные маршруты и доставку, оценивать время и расстояния, анализировать данные о местах, обогащать записи географическим контекстом, получать информацию об окружающей среде и многое другое — все без ручной работы или внешних инструментов.
Если вам нужны возможности, выходящие за рамки перечисленных здесь, или вы хотите запросить поддержку дополнительных API Google Maps, дайте нам знать!
Интегрируйте API Google Maps Platform в ваш рабочий процесс. Поддерживает геокодирование адресов в координаты, обратное геокодирование, получение маршрутов между местоположениями, расчет матриц расстояний, поиск мест, получение деталей о местах, данные о высоте и информацию о часовых поясах.
Получить текущие данные о качестве воздуха для местоположения
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps с включенным Air Quality API |
lat | number | Да | Координата широты |
lng | number | Да | Координата долготы |
languageCode | string | Нет | Код языка для ответа (например, "en", "es") |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
dateTime | string | Временная метка данных о качестве воздуха |
regionCode | string | Код региона для местоположения |
indexes | array | Массив индексов качества воздуха |
↳ code | string | Код индекса (например, "uaqi", "usa_epa") |
↳ displayName | string | Отображаемое имя индекса |
↳ aqi | number | Значение индекса качества воздуха |
↳ aqiDisplay | string | Форматированная строка отображения AQI |
↳ color | object | Цвет RGB для уровня AQI |
↳ category | string | Описание категории (например, "Good", "Moderate") |
↳ dominantPollutant | string | Доминирующий загрязнитель |
pollutants | array | Массив концентраций загрязнителей |
↳ code | string | Код загрязнителя (например, "pm25", "o3") |
↳ displayName | string | Отображаемое имя |
↳ fullName | string | Полное имя загрязнителя |
↳ concentration | object | Информация о концентрации |
↳ value | number | Значение концентрации |
↳ units | string | Единицы измерения (например, "PARTS_PER_BILLION") |
↳ additionalInfo | object | Дополнительная информация об источниках и эффектах |
healthRecommendations | object | Рекомендации по здоровью для разных групп населения |
Получить маршруты и информацию о пути между двумя местоположениями
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
origin | string | Да | Начальное местоположение (адрес или lat,lng) |
destination | string | Да | Местоположение назначения (адрес или lat,lng) |
mode | string | Нет | Режим передвижения: driving, walking, bicycling или transit |
avoid | string | Нет | Особенности, которых следует избегать: tolls, highways или ferries |
waypoints | json | Нет | Массив промежуточных точек маршрута |
units | string | Нет | Система единиц: metric или imperial |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
routes | array | Все доступные маршруты |
↳ summary | string | Краткое описание маршрута (основные названия дорог) |
↳ legs | array | Сегменты маршрута (участки между точками маршрута) |
↳ overviewPolyline | string | Закодированная полилиния для всего маршрута |
↳ warnings | array | Предупреждения о маршруте |
↳ waypointOrder | array | Оптимизированный порядок точек маршрута (если запрошено) |
distanceText | string | Общее расстояние в удобочитаемом формате (например, "5.2 km") |
distanceMeters | number | Общее расстояние в метрах |
durationText | string | Общая продолжительность в удобочитаемом формате (например, "15 mins") |
durationSeconds | number | Общая продолжительность в секундах |
startAddress | string | Разрешенный начальный адрес |
endAddress | string | Разрешенный конечный адрес |
steps | array | Пошаговые инструкции навигации |
↳ instruction | string | Инструкция навигации (HTML удален) |
↳ distanceText | string | Расстояние шага в текстовом формате |
↳ distanceMeters | number | Расстояние шага в метрах |
↳ durationText | string | Продолжительность шага в текстовом формате |
↳ durationSeconds | number | Продолжительность шага в секундах |
↳ startLocation | object | Координаты начала шага |
↳ endLocation | object | Координаты конца шага |
↳ travelMode | string | Режим передвижения для этого шага |
↳ maneuver | string | Тип маневра (turn-left и т.д.) |
polyline | string | Закодированная полилиния для основного маршрута |
Рассчитать расстояние и время в пути между несколькими точками отправления и назначения
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
origin | string | Да | Местоположение отправления (адрес или lat,lng) |
destinations | json | Да | Массив местоположений назначения |
mode | string | Нет | Режим передвижения: driving, walking, bicycling или transit |
avoid | string | Нет | Особенности, которых следует избегать: tolls, highways или ferries |
units | string | Нет | Система единиц: metric или imperial |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
originAddresses | array | Разрешенные адреса отправления |
destinationAddresses | array | Разрешенные адреса назначения |
rows | array | Строки матрицы расстояний (по одной на точку отправления) |
↳ elements | array | Элементы (по одному на точку назначения) |
↳ distanceText | string | Расстояние в текстовом формате (например, "5.2 km") |
↳ distanceMeters | number | Расстояние в метрах |
↳ durationText | string | Продолжительность в текстовом формате (например, "15 mins") |
↳ durationSeconds | number | Продолжительность в секундах |
↳ durationInTrafficText | string | Продолжительность с учетом трафика в текстовом формате |
↳ durationInTrafficSeconds | number | Продолжительность с учетом трафика в секундах |
↳ status | string | Статус элемента (OK, NOT_FOUND, ZERO_RESULTS) |
Получить данные о высоте для местоположения
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
lat | number | Да | Координата широты |
lng | number | Да | Координата долготы |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
elevation | number | Высота в метрах над уровнем моря (отрицательное значение для ниже уровня моря) |
lat | number | Широта образца высоты |
lng | number | Долгота образца высоты |
resolution | number | Максимальное расстояние между точками данных (метры), из которого была интерполирована высота |
Преобразовать адрес в географические координаты (широту и долготу)
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
address | string | Да | Адрес для геокодирования |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
region | string | Нет | Смещение региона в виде кода ccTLD (например, us, uk) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
formattedAddress | string | Форматированная строка адреса |
lat | number | Координата широты |
lng | number | Координата долготы |
location | json | Объект местоположения с lat и lng |
placeId | string | Google Place ID для этого местоположения |
addressComponents | array | Подробные компоненты адреса |
↳ longName | string | Полное имя компонента |
↳ shortName | string | Сокращенное имя |
↳ types | array | Типы компонентов |
locationType | string | Тип точности местоположения (ROOFTOP, RANGE_INTERPOLATED и т.д.) |
Геолокация устройства с использованием точек доступа WiFi, вышек сотовой связи или IP-адреса
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps с включенным Geolocation API |
homeMobileCountryCode | number | Нет | Код мобильной страны (MCC) домашней сети |
homeMobileNetworkCode | number | Нет | Код мобильной сети (MNC) домашней сети |
radioType | string | Нет | Тип радио: lte, gsm, cdma, wcdma или nr |
carrier | string | Нет | Название оператора связи |
considerIp | boolean | Нет | Использовать ли IP-адрес для геолокации (по умолчанию: true) |
cellTowers | array | Нет | Массив объектов вышек сотовой связи с cellId, locationAreaCode, mobileCountryCode, mobileNetworkCode |
wifiAccessPoints | array | Нет | Массив объектов точек доступа WiFi с macAddress (обязательно), signalStrength и т.д. |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
lat | number | Координата широты |
lng | number | Координата долготы |
accuracy | number | Радиус точности в метрах |
Получить подробную информацию о конкретном месте
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
placeId | string | Да | Google Place ID |
fields | string | Нет | Список полей для возврата через запятую |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
placeId | string | Google Place ID |
name | string | Название места |
formattedAddress | string | Форматированный почтовый адрес |
lat | number | Координата широты |
lng | number | Координата долготы |
types | array | Типы места (например, restaurant, cafe) |
rating | number | Средний рейтинг (от 1.0 до 5.0) |
userRatingsTotal | number | Общее количество оценок пользователей |
priceLevel | number | Уровень цен (0=Бесплатно, 1=Недорого, 2=Умеренно, 3=Дорого, 4=Очень дорого) |
website | string | URL веб-сайта места |
phoneNumber | string | Локальный форматированный номер телефона |
internationalPhoneNumber | string | Международный форматированный номер телефона |
openNow | boolean | Открыто ли место в настоящее время |
weekdayText | array | Часы работы, отформатированные по дням недели |
reviews | array | Отзывы пользователей (до 5 наиболее релевантных) |
↳ authorName | string | Имя рецензента |
↳ authorUrl | string | URL профиля рецензента |
↳ profilePhotoUrl | string | URL фотографии рецензента |
↳ rating | number | Оценка (1-5) |
↳ text | string | Текст отзыва |
↳ time | number | Временная метка отзыва (Unix epoch) |
↳ relativeTimeDescription | string | Относительное время (например, "a month ago") |
photos | array | Фотографии места |
↳ photoReference | string | Ссылка на фото для Place Photos API |
↳ height | number | Высота фото в пикселях |
↳ width | number | Ширина фото в пикселях |
↳ htmlAttributions | array | Обязательные атрибуции |
url | string | URL Google Maps для места |
utcOffset | number | Смещение UTC в минутах |
vicinity | string | Упрощенный адрес (район/улица) |
businessStatus | string | Статус бизнеса (OPERATIONAL, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY) |
Искать места с помощью текстового запроса
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
query | string | Да | Поисковый запрос (например, "restaurants in Times Square") |
location | json | Нет | Местоположение для смещения результатов ({lat, lng}) |
radius | number | Нет | Радиус поиска в метрах |
type | string | Нет | Фильтр типа места (например, restaurant, cafe, hotel) |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
region | string | Нет | Смещение региона в виде кода ccTLD (например, us, uk) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
places | array | Список найденных мест |
↳ placeId | string | Google Place ID |
↳ name | string | Название места |
↳ formattedAddress | string | Форматированный адрес |
↳ lat | number | Широта |
↳ lng | number | Долгота |
↳ types | array | Типы места |
↳ rating | number | Средний рейтинг (1-5) |
↳ userRatingsTotal | number | Количество оценок |
↳ priceLevel | number | Уровень цен (0-4) |
↳ openNow | boolean | Открыто ли в настоящее время |
↳ photoReference | string | Ссылка на фото для Photos API |
↳ businessStatus | string | Статус бизнеса |
nextPageToken | string | Токен для получения следующей страницы результатов |
Преобразовать географические координаты (широту и долготу) в удобочитаемый адрес
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
lat | number | Да | Координата широты |
lng | number | Да | Координата долготы |
language | string | Нет | Код языка для результатов (например, en, es, fr) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
formattedAddress | string | Форматированная строка адреса |
placeId | string | Google Place ID для этого местоположения |
addressComponents | array | Подробные компоненты адреса |
↳ longName | string | Полное имя компонента |
↳ shortName | string | Сокращенное имя |
↳ types | array | Типы компонентов |
types | array | Типы адреса (например, street_address, route) |
Привязать GPS-координаты к ближайшему сегменту дороги
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps с включенным Roads API |
path | string | Да | Список координат lat,lng, разделенных вертикальной чертой (например, "60.170880,24.942795|60.170879,24.942796") |
interpolate | boolean | Нет | Интерполировать ли дополнительные точки вдоль дороги |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
snappedPoints | array | Массив привязанных точек на дорогах |
↳ location | object | Координаты привязанного местоположения |
↳ lat | number | Широта |
↳ lng | number | Долгота |
↳ originalIndex | number | Индекс в исходном пути (если не интерполировано) |
↳ placeId | string | Place ID для этого сегмента дороги |
warningMessage | string | Предупреждающее сообщение, если есть (например, если точки не удалось привязать) |
Получить ограничения скорости для сегментов дорог. Требуются либо координаты пути, либо placeIds.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps с включенным Roads API |
path | string | Нет | Список координат lat,lng, разделенных вертикальной чертой (обязательно, если не указаны placeIds) |
placeIds | array | Нет | Массив Place ID для сегментов дорог (обязательно, если не указан path) |
| Параметр | Тип | Описание |
|---|
speedLimits | array | Массив ограничений скорости для сегментов дорог |
↳ placeId | string | Place ID для сегмента дороги |
↳ speedLimit | number | Значение ограничения скорости |
↳ units | string | Единицы ограничения скорости (KPH или MPH) |
snappedPoints | array | Массив привязанных точек, соответствующих ограничениям скорости |
↳ location | object | Координаты привязанного местоположения |
↳ lat | number | Широта |
↳ lng | number | Долгота |
↳ originalIndex | number | Индекс в исходном пути |
↳ placeId | string | Place ID для этого сегмента дороги |
Получить информацию о часовом поясе для местоположения
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps |
lat | number | Да | Координата широты |
lng | number | Да | Координата долготы |
timestamp | number | Нет | Метка времени Unix для определения смещения DST (по умолчанию текущее время) |
language | string | Нет | Код языка для названия часового пояса (например, en, es, fr) |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
timeZoneId | string | Идентификатор часового пояса IANA (например, "America/New_York", "Europe/London") |
timeZoneName | string | Локализованное название часового пояса (например, "Eastern Daylight Time") |
rawOffset | number | Смещение UTC в секундах (без DST) |
dstOffset | number | Смещение летнего времени в секундах (0, если не в DST) |
totalOffsetSeconds | number | Общее смещение UTC в секундах (rawOffset + dstOffset) |
totalOffsetHours | number | Общее смещение UTC в часах (например, -5 для EST, -4 для EDT) |
Проверить и стандартизировать почтовый адрес
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Google Maps с включенным Address Validation API |
address | string | Да | Адрес для проверки (в виде одной строки) |
regionCode | string | Нет | Код страны ISO 3166-1 alpha-2 (например, "US", "CA") |
locality | string | Нет | Название города или населенного пункта |
enableUspsCass | boolean | Нет | Включить проверку USPS CASS для адресов в США |
pricing | per_request | Нет | Нет описания |
rateLimit | string | Нет | Нет описания |
| Параметр | Тип | Описание |
|---|
formattedAddress | string | Стандартизированный форматированный адрес |
lat | number | Координата широты |
lng | number | Координата долготы |
placeId | string | Google Place ID для этого адреса |
addressComplete | boolean | Является ли адрес полным и доставляемым |
hasUnconfirmedComponents | boolean | Не удалось ли подтвердить некоторые компоненты адреса |
hasInferredComponents | boolean | Были ли некоторые компоненты выведены (не во входных данных) |
hasReplacedComponents | boolean | Были ли некоторые компоненты заменены каноническими значениями |
validationGranularity | string | Гранулярность проверки (PREMISE, SUB_PREMISE, ROUTE и т.д.) |
geocodeGranularity | string | Гранулярность результата геокодирования |
addressComponents | array | Подробные компоненты адреса |
↳ longName | string | Полное имя компонента |
↳ shortName | string | Сокращенное имя |
↳ types | array | Типы компонентов |
missingComponentTypes | array | Типы компонентов адреса, которые отсутствуют |
unconfirmedComponentTypes | array | Типы компонентов, которые не удалось подтвердить |
unresolvedTokens | array | Входные токены, которые не удалось разрешить |
