Коннектор геокодов Google

Интеграция с API геокода Google

Введение

Геокодирование - это процесс преобразования адресов, которые пользователи могут использовать для размещения маркеров на карте или позиционирования карты. Аналогично, обратное геокодирование - это процесс преобразования географических координат в человекочитаемый адрес. Цель данного коннектора - интегрировать Google Geocode API с Tulip с помощью HTTP-коннекторов и предоставить нашим клиентам готовый коннектор Geocode, который можно импортировать в их экземпляр.

Назначение

1. Мы рассмотрим различные функции HTTP-коннекторов, которые можно построить, выполняя HTTP-вызовы к конечным точкам Google Geocode API для получения подробной информации об адресе, получения его координат, что может быть использовано для различных сценариев использования. Использование обратного геокодирования с передачей координат и получением всей информации об адресе, а также демонстрация применения фильтров к этим вызовам API.
2. Кроме того, мы используем API Distance Matrix от Google, чтобы показать, как можно получить информацию о расстоянии и продолжительности поездки между двумя адресами или координатами, полученными с помощью API Geocoding, как описано выше.

Документ API

1. Документация Google Geocode API
2. Документация API Google Distance Matrix

Предварительные требования

1. Создайте учетную запись в облачной консоли Google и настройте ключ API для Google Geocode. Более подробную информацию можно найти в документации Google по API.
2. Полученный API-ключ будет использоваться в качестве параметра запроса во всех функциях коннектора для Geocode и Distance Matrix. Пользователям необходимо убедиться, что их API-ключи либо переданы через экстрактор ввода Tulip, либо введены во всех функциях коннектора.

Детали подключения Tulip

Для коннекторов Tulip необходимо настроить следующую информацию.

1. Работает на: хосте облачного коннектора
2. Хост: maps.googleapis.com
3. Порт:443
4. TLS:Да
5. Аутентификация не требуется: Достаточно API-ключа для каждого вызова.

Функции коннектора

Получение информации об адресе

Назначение

1. Пользователь может передать поисковый запрос в качестве входного адреса, и Tulip получит всю важную информацию о конкретном адресе и эквивалентных ему координатах широты и долготы, которые в дальнейшем могут быть использованы в качестве маркеров на картах или для других целей.
2. Информация, полученная из Geocode, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора, являющиеся частью Geocode Connector.

Конечная точка

1. HTTP GET вызов конечной точки -https://maps.googleapis.com:443/maps/api/geocode/json.

Требуемый ввод

Ниже перечислены параметры запроса, которые необходимо передать

1. API-ключ
2. Адрес - Адрес для поискового запроса

Требуемый выходной экстрактор

1. Полный адрес: Форматированный полный адрес, возвращаемый Google.
2. Широта: Координаты, используемые для отметок на карте или используемые при передаче в API матрицы расстояний.
3. Долгота : Координаты, используемые для маркеров на карте или передаваемые в API матрицы расстояний.
4. Тип местоположения : Индикатор типа искомого местоположения.

Получение адресной информации по региону

Назначение

1. Данная функция аналогична описанной выше с возможностью передачи дополнительного параметра запроса в функцию коннектора. Часто бывает так, что адрес находится в нескольких странах, и для получения нужного результата пользователь может передать код страны в параметре region функции коннектора, чтобы убедиться, что возвращаемые результаты относятся к интересующей его стране.
2. Регион - это один из параметров запроса, который пользователь может использовать для фильтрации результатов, однако Google предлагает множество других параметров запроса, которые могут быть использованы при обращении к Geocode API. Более подробную информацию об этом можно найти в документации по API.

Конечная точка и заголовки

1. HTTP GET вызов конечной точкиhttps://maps.googleapis.com:443/maps/api/geocode/json.

Необходимые параметры

Ниже перечислены параметры запроса, которые необходимо передать

1. API-ключ
2. Адрес - Адрес для поискового запроса
3. Регион - интересующая страна

Требуемые выходные экстракторы

1. Полный адрес: Форматированный полный адрес, возвращаемый Google.
2. Широта: Координаты, используемые для маркеров на карте или для передачи в API матрицы расстояний.
3. Долгота : Координаты, используемые для маркеров на карте или передаваемые в API матрицы расстояний.
4. Тип местоположения : Индикатор типа искомого местоположения.

Обратное геокодирование

Назначение

1. Обратное геокодирование - это процесс преобразования географических координат в человекочитаемый адрес.
2. Эта функция коннектора принимает координаты в качестве входных данных и возвращает человекочитаемый адрес и все остальные детали, такие как различные компоненты адреса, которые возвращаются API.

Конечная точка и заголовки

1. HTTP GET вызов конечной точкиhttps://maps.googleapis.com:443/maps/api/geocode/json.

Требуемые входные данные

Ниже перечислены параметры запроса, которые необходимо передать

1. API-ключ
2. ШиротаДолгота: Пользователи должны передать координаты, разделенные запятой.

Требуемые выходные параметры

1. Полный адрес: Форматированный полный адрес, возвращаемый Google.
2. Тип местоположения : Индикатор типа искомого местоположения.

Обратное геокодирование с помощью фильтров

Назначение

1. Эта функция коннектора используется точно так же, как и предыдущая, однако Geocode API возвращает несколько строк результатов для координат, переданных для определения местоположения. Данная функция демонстрирует, как можно использовать различные параметры запроса, предлагаемые API, для фильтрации результатов на интересующие вас.

Конечная точка и заголовки

1. HTTP GET вызов конечной точкиhttps://maps.googleapis.com:443/maps/api/geocode/json.

Требуемый ввод

Ниже перечислены параметры запроса, которые необходимо передать

1. Ключ API
2. ШиротаДолгота: Пользователи должны передать координаты, разделенные запятой.
3. Тип местоположения: Параметр запроса, указывающий на то, что API возвращает результаты для точных или приблизительных адресов.
4. Result Type : Параметр запроса, указывающий на необходимость получения результатов по уличному адресу, адресу учреждения и другим параметрам, которые можно найти в документации по API.

Необходимые выходные экстракторы

1. Полный адрес: Форматированный полный адрес, возвращаемый Google.
2. Тип местоположения : Индикатор типа искомого местоположения.

Расстояние и продолжительность

Назначение

1. Данная функция выполняет HTTP-вызов API Distance Matrix, который предоставляет информацию о расстоянии и времени в пути для матрицы начальных и конечных пунктов. API возвращает информацию, основанную на рекомендуемом маршруте между начальной и конечной точками, рассчитанном Google Maps API.
2. Для получения расстояния и времени в пути между двумя точками используются либо полные адреса, либо координаты, возвращаемые geocode api.

Конечная точка и заголовки

1. HTTP GET вызов конечной точкиhttps://maps.googleapis.com:443//maps/api/distancematrix/json.

Необходимые параметры

Ниже перечислены параметры запроса, которые необходимо передать

1. API-ключ
2. Origin - начальный адрес/координаты
3. Destination - конечный адрес/координаты
4. Единицы измерения - по умолчанию метрические, но могут быть переданы и имперские.

Требуемые выходные данные

1. Расстояние : Расстояние между 2 входными адресами
2. Duration : Время, затраченное на прохождение пути между двумя адресами.

Получение расстояния и продолжительности с параметрами

Назначение

1. Данная функция используется точно так же, как и описанная ранее функция connector, однако для получения результатов мы передаем дополнительные параметры запроса.
2. Вождение автомобиля является видом транспорта по умолчанию, когда Distance Matrix API возвращает результат о продолжительности и расстоянии между двумя адресами. Если же необходимо получить результаты по другим видам транспорта, например, по железной дороге, метро или пешком, мы можем использовать дополнительные параметры запроса google для получения нужных данных.

Конечная точка и заголовки

1. HTTP GET-вызов конечной точкиhttps://maps.googleapis.com:443//maps/api/distancematrix/json.

Необходимые параметры

Ниже перечислены параметры запроса, которые необходимо передать

1. API-ключ
2. Origin - начальный адрес/координаты
3. Destination - конечный адрес/координаты
4. Единицы измерения - по умолчанию метрические, но можно передать и имперские.
5. Режим движения: Для указания другого способа передвижения, отличного от установленного по умолчанию.
6. Transit Mode (Транзитный режим): Подрежим поездки в рамках родительского режима. (Железнодорожный транспорт/подземный транспорт в разделе "Транзит")

Необходимые выходные данные

1. Расстояние : Расстояние между 2 адресами ввода
2. Продолжительность: Время, затраченное на проезд между двумя адресами.