Google 지오코드 커넥터

Google의 지오코드 API와 통합

소개

지오코딩은 사용자가 지도에 마커를 배치하거나 지도의 위치를 지정하는 데 사용할 수 있는 주소 를 변환하는 프로세스입니다. 마찬가지로 리버스 지오코딩은 지리적 좌표를 사람이 읽을 수 있는 주소로 변환하는 과정으로, 이 커넥터의 목표는 HTTP 커넥터를 사용하여 Google의 지오코드 API를 Tulip과 통합하고 고객에게 인스턴스로 가져올 수 있는 즉시 사용 가능한 지오코드 커넥터를 제공하는 것입니다.

목적

1. Google의 지오코드 API 엔드포인트에 대한 HTTP 호출을 수행하여 주소에 대한 자세한 정보를 가져와 다양한 사용 사례에 활용할 수 있는 좌표를 얻는 다양한 HTTP 커넥터 기능을 강조하겠습니다. 좌표를 전달하여 역지오코딩을 사용하여 주소에 대한 모든 정보를 얻고 이러한 API 호출에 필터를 적용하는 방법을 보여드립니다.
2. 또한 Google의 거리 매트릭스 API를 사용하여 위에서 설명한 대로 지오코딩 API를 통해 얻은 두 주소 또는 좌표 사이의 이동 거리 및 소요 시간에 대한 정보를 가져오는 방법을 보여드리겠습니다.

API 문서

1. Google 지오코딩 API 문서
2. 구글 거리 매트릭스 API 문서

사전 요구 사항

1. Google 클라우드 콘솔에서 계정을 만들고 Google 지오코드용 API 키를 구성합니다. 자세한 내용은 Google의 API 문서에서 확인할 수 있습니다.
2. 생성된 API 키는 지오코드 및 거리 매트릭스에 대한 모든 커넥터 기능에서 쿼리 매개변수로 사용됩니다. 사용자는 API 키를 Tulip의 입력 추출기를 통해 전달하거나 모든 커넥터 함수에 입력해야 합니다.

튤립 연결 세부 정보

Tulip의 커넥터에 다음 정보를 구성해야 합니다.

1. 실행 대상: 클라우드 커넥터 호스트
2. 호스트 : maps.googleapis.com
3. 포트:443
4. TLS:예
5. 인증이 필요하지 않습니다: 각 호출에 대한 API 키로 충분합니다.

커넥터 기능

주소 정보 가져오기

목적

1. 사용자가 검색 쿼리를 입력 주소로 전달하면 Tulip은 특정 주소에 대한 모든 중요한 정보와 그에 해당하는 위도 및 경도 좌표를 가져와 지도의 마커로 사용하거나 다른 사용 사례에 사용할 수 있습니다.
2. 지오코드에서 가져온 정보는 지오코드 커넥터의 일부인 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

1. 엔드포인트에 대한 HTTP GET 호출 -https://maps.googleapis.com:443/maps/api/geocode/json

필수 입력

전달해야 할 쿼리 매개변수는 다음과 같습니다.

1. API 키
2. 주소 - 검색 쿼리의 주소

필수 출력 추출기

1. 전체 주소: Google에서 반환한 형식화된 전체 주소입니다.
2. 위도: 지도의 마커에 사용되거나 거리 매트릭스 API를 전달하여 사용하는 좌표입니다.
3. 경도 : 지도의 마커에 사용되거나 거리 행렬 API를 전달하여 사용하는 좌표입니다.
4. 위치 유형 : 위치 유형: 검색한 위치의 종류를 나타내는 표시기입니다.

지역으로 주소 정보 가져오기

목적

1. 이 함수는 위에서 설명한 것과 유사하지만 커넥터 함수에 추가 쿼리 파라미터를 전달할 수 있는 옵션이 있습니다. 주소가 여러 국가에 있는 경우가 많은데, 원하는 결과를 얻기 위해 사용자는 커넥터 함수의 지역 매개변수에 국가 코드를 전달하여 반환되는 결과가 관심 있는 국가의 결과인지 확인할 수 있습니다.
2. 지역은 사용자가 결과를 필터링하는 데 활용할 수 있는 쿼리 매개변수 중 하나이지만, Google은 지오코드 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. 엔드포인트https://maps.googleapis.com:443/maps/api/geocode/json 에 대한 HTTP GET 호출

필수 입력

전달해야 하는 쿼리 매개변수는 다음과 같습니다.

1. API 키
2. LatitudeLongitude: 좌표를 쉼표로 구분하여 전달해야 합니다.

필수 출력 추출기

1. 전체 주소: Google에서 반환한 형식화된 전체 주소입니다.
2. 위치 유형: 검색한 위치의 종류를 나타내는 표시기입니다.

필터를 사용한 역 지오코딩

목적

1. 이 커넥터 함수는 위에서 언급한 것과 동일하게 사용되지만 지오코딩 API는 위치에 대해 전달된 좌표에 대한 여러 행의 결과를 반환합니다. 이 함수는 API에서 제공하는 다양한 쿼리 매개변수를 활용하여 결과를 관심 있는 항목으로 필터링하는 방법을 보여줍니다.

엔드포인트 및 헤더

1. 엔드포인트https://maps.googleapis.com:443/maps/api/geocode/json 에 대한 HTTP GET 호출

필수 입력

전달해야 하는 쿼리 매개변수는 다음과 같습니다.

1. API 키
2. LatitudeLongitude: 좌표를 쉼표로 구분하여 전달해야 합니다.
3. 위치 유형: 정확한 주소 또는 대략적인 주소에 대한 API 반환 결과를 나타내는 쿼리 매개변수입니다.
4. 결과 유형: API 문서에서 사용할 수 있는 다른 옵션 중 거리 주소, 시설에 필요한 결과를 나타내는 쿼리 파라미터입니다.

필수 출력 추출기

1. 전체 주소: Google에서 반환한 형식화된 전체 주소입니다.
2. 위치 유형: 검색된 위치의 종류를 나타내는 표시기입니다.

거리 및 시간 가져오기

목적

1. 이 함수는 출발지와 목적지의 행렬에 대한 이동 거리와 시간을 제공하는 거리 매트릭스 API를 HTTP로 호출합니다. API는 Google 지도 API에서 계산한 시작점과 끝점 사이의 권장 경로를 기반으로 정보를 반환합니다.
2. 지오코드 API가 반환하는 전체 주소 또는 좌표를 활용하여 두 지점 간의 이동 거리 및 시간을 구합니다.

엔드포인트 및 헤더

1. 엔드포인트에 대한 HTTP GET 호출https://maps.googleapis.com:443//maps/api/distancematrix/json

필수 입력

전달해야 하는 쿼리 파라미터는 다음과 같습니다.

1. API 키
2. 출발지 - 시작 주소/좌표
3. 목적지 - 종료 주소/좌표
4. 단위 - 기본값은 미터법이지만 영국식도 전달할 수 있습니다.

필수 출력

1. 거리 : 입력 주소 2개 사이의 거리
2. Duration : 두 입력 주소를 흑백으로 이동하는 데 걸린 시간입니다.

매개변수로 거리 및 소요 시간 가져오기

목적

1. 이 함수는 앞서 설명한 커넥터 함수와 동일한 방식으로 사용되지만 결과를 얻기 위해 추가 쿼리 매개변수를 전달합니다.
2. 거리 매트릭스 API가 두 위치 사이의 지속 시간 및 거리 결과를 반환할 때 기본 전송 모드는 운전입니다. 철도, 지하철 또는 도보와 같은 다른 교통수단을 사용하여 결과를 얻으려는 사용 사례가 있는 경우 Google의 추가 쿼리 매개변수를 활용하여 원하는 데이터를 얻을 수 있습니다.

엔드포인트 및 헤더

1. 엔드포인트에 대한 HTTP GET 호출https://maps.googleapis.com:443//maps/api/distancematrix/json

필수 입력

전달해야 하는 쿼리 매개변수는 다음과 같습니다.

1. API 키
2. 출발지 - 시작 주소/좌표
3. 목적지 - 종료 주소/좌표
4. 단위 - 기본값은 미터법이지만 영국식도 전달할 수 있습니다.
5. 여행 모드: 기본 모드인 주행이 아닌 다른 모드를 지정하려면 다음과 같이 입력합니다.
6. 환승 모드: 상위 모드 내의 하위 이동 모드입니다. (대중교통 아래의 철도/지하철)

필수 출력

1. 거리: 거리 흑백 입력 주소 2개
2. Duration : 흑백 2 입력 주소를 이동하는 데 걸리는 시간.