Google Maps Platform
Google API Console
Google API Console
Google API Console에서는 Javascript 이외의 API를 생성 및 삭제 관리가 가능합니다. 라이센스 구매하시고 받으신 웰컴레터에 있는 프로젝트 링크를 클릭하면 구매하신 라이센스가 적용된 프로젝트로 바로 이동합니다.
Google API Console에 초기 생성된 프로젝트 하위에 생성하는 API는 구매한 라이센스가 종속되어서 적용됩니다.( Asset Tracking 라이센스는 Web Service Place API 제외).
만약 새로운 프로젝트를 만들어서 사용한다면 해당 프로젝트 하위에 생성한 API는 구매한 라이센스 적용이 되지 않으니 유의하시기 바랍니다.
Google API Console
- 프로젝트 선택 및 API 사용 설정
- API Key 생성 방법
- API Key 세부 설정
- URL Signing
프로젝트 선택 및 API 사용 설정
프로젝트 선택
- Google Console API에 로그인하여 할당받은 프로젝트를 선택합니다.
2. API Key가 속할 프로젝트를 선택합니다.
3. 프로젝트를 선택한 후의 대시보드 화면
- 사용 가능한 API
- 사용자가 사용가능한 API 목록을 확인할 수 있습니다.
- 사용자가 사용 설정을 따로 진행하지 않아도 사용할 수 있는 API들을 확인할 수 있습니다.
- 사용 설정하지 않아도 사용 가능한 API 목록
- Directions API
- Distance Matrix API – Geocoding API
- Maps Elevation API – Maps JavaScript API – Places API
- Roads API
- Street View API
API 사용 설정
API 및 서비스 사용 설정
– 각 API에 대한 사용/미사용 여부 를 지정할 수 있습니다.
– 좌측 API 및 서비스 > 라이브러 리 메뉴를 통해서 이동할 수 있습니다. (동일 화면으로 이동)
——————————————————————————————————————————————–
1. API 필터 선택
– 좌측 API 구분을 Maps로 지정하면 Google Map API만 조회할 수 있습니다.
2. API 선택
– 사용 여부를 지정하기를 원하는 API를 선택합니다.
——————————————————————————————————————————————–
1. [사용 설정] 선택
– 해당 버튼을 클릭하여 선택한 API에 대한 사용 여부를 설정합니다
– 사용 설정이 되어있지 않은 API 의 경우, 해당 버튼을 클릭하면 사용 설정 상태로 변경됩니다.
2. API 설정 확인
– 1번 버튼을 클릭하면 이동하는 화면입니다.
3. [사용 중지] 선택
– 해당 버튼을 클릭하면 사용 설정 된 API의 사용 설정을 중지할 수 있습니다.
4. API 사용 설정 (설정된 경우)
– 기존에 사용 설정된 API의 경우 1 번 버튼이 [관리] 버튼으로 변경되고, 해당 이미지와 같은 아이콘과 문구를 확인 할 수 있습니다.
– [관리] 버튼을 클릭할 경우 2번 화면으로 이동합니다.
대표 API 목록
기본적으로 설정해주는 API를 포함하여 주로 사용하는 API 추천 목록으로, 가급적 사용 설정하는 것을 추천합니다.
API Key 생성 방법
API Key 생성 방법
1. [사용자 인증 정보] 메뉴 선택
– API 및 서비스 > 사용자 인증 정 보 메뉴를 선택하여 API Key를 관 리하는 화면으로 이동합니다.
2. [사용자 인증 정보 만들기] 선택
– 해당 버튼을 클릭하면 하위 메뉴 가 생성된다.
3. API생성
– [API 키] 메뉴를 선택하면 자동으 로 API Key가 생성된다.
——————————————————————————————————————————————–
1.API Key 확인
– API Key가 생성된 직후의 화면
– 생성된 API Key를 확인 및 복사 할 수 있습니다.
2. [키 제한] 선택
– API 키를 사용하기 위한 제한 사 항을 설정하는 화면으로 이동할 수 있습니다.
API Key 세부 설정
API Key 세부 설정
API의 설정 사항을 수정합니다.
1. API Key 이름
– 생성된 API Key의 이름을 부여 및 수정할 수 있습니다.
2 .어플리케이션 제한사항 설정
– 가급적 제한 사항을 설정합니다. (권장사항)
– API Key를 사용할 어플리케이션에 대한 제한 사항을 설정합니다.
3 .저장
– 수정된 정보를 저장합니다.
– 해당 버튼을 클릭하지 않으면 입력 및 수정한 정보들이 저장되지 않습니다.
——————————————————————————————————————————————–
• API Key의 어플리케이션 제한 사항 상세 내역
API Key에 대하여 각 종류 및 타입에 따른 어플리케이션 제한 사항을 설정할 수 있습니다.
——————————————————————————————————————————————–
1. API 제한 사항 (Optional)
– 사용을 원하는 API를 선택할 수 있습니다.
– 선택되지 않은 API에서는 해당 API Key를 사용 할 수 없습니다.
2. API 선택
– API 제한사항 Combo box를 선택하면 표시되는 API 목록입니다.
– API 사용 설정이 되어있는 API에 한해서 선택할 수 있습니다.
URL Signing (Digital Signatures)
URL Signing
- 일부 API에 대한 요청에는 암호화 알고리즘을 사용하여 URL 과 암호키를 결합해 고유한 서명 (Signature) 을 파라미터로 필요로 합니다.
이를 통해 생성된 파라미터를 디지털 서명(Digital Signature)이라고 하며, 이 과정을 URL Signing 이라고 합니다. - Post pay 고객은 URL 서명 비 번호 (URL Signing secret) 을 암호키로 사용합니다.
- Post pay 고객의 URL 서명 비밀번호는 Console에서 변경 가능합니다.
- 웹 서비스 API의 경우, 요청한 서버의 IP에 따라 제한될 수 있으므로, URL Signing이 필요치 않습니다. (HTTP Referer 제한 설정)하지만 정적 참조 이미지를 사용하는 Static Map API와 Street View API의 경우 HTTP Referer를 사용할 수 없는 경우가 있기 때문에 Digital Signature 를 추가하여 추가적으로 Key를 보호해야 합니다.
- URL Signing 을 진행할 때, URL 의 전체 주소 ( HTTP Protocol 부터 전체 파라미터를 모두 포함한 Full Address ) 를 URL로 사용하여야 합니다. 비표준 문자는 UTF-8 인코딩이 필요합니다.
-
구글 내부 정책상, Signature 파라미터가 필요한 API는 다음과 같습니다.
사용 방법
사용 방법
- Google Cloud Platform Console 에 접속합니다.
- 대시보드 하단의 사용 설정된 API 중 Signature 를 생성할 API 를 선택합니다.
- 상단에 [URL 서명 비밀번호 ( URL signing secret )] 탭을 선택하면 URL Signing비밀번호를 발급받을 수 있습니다.
- 발급된 비밀번호를 사용하여 API 를 호출하는 URL과 함께 URL Signing 을 진행하여API를 호출합니다. ● URL Signing Sample Code: https://developers.google.com/maps/documentation/maps-static/get-api-key#dig-sig-key
5. 주의사항
a. [URL 서명 비밀번호] 탭에서 [서명되지 않은 사용 허용] 을 선택하면 Signature없이 호출이 가능합니다.
b.무단 사용을 방지하기 위해 Signature 가 없을 경우 API 별 하루 25,000개 까지의 호출만 가능합니다.
※ 참고 URL
● API키용 디지털 서명 생성
https://developers.google.com/maps/documentation/maps-static/get-api-key?hl=ko#dig-sig-key
Digital signature 생성 방법
API Key 를 사용하는 고객과 Client ID 를 사용하는 고객의 차이점은, URL 서명 비밀번호를 할당받는 부분만 다를뿐, 나머지 단계는 동일합니다.
- API Key를 사용하는 고객의 경우, Console 에 접속하여 각 API에 대한 URL 서명 비밀번호(URL Signing Secret)를 할당받아야 합니다.
- URL 서명 비밀번호는 URL Signing 이 필요한 API에 한하여 생성할 수 있습니다.
————————————————————————————————————————————————–
Post Pay 고객 URL 서명 비밀번호 생성 방법
Step1. Console 에 접속하여 URL Signing 을 진행할 API를 선택합니다.
Step2. 상단에 [URL 서명 비밀번호 ( URL signing secret ) ] 탭으로 이동합니다. 해당 탭은 Static Maps API 또는 Street View API 에만 존재합니다.
Step3. HMAC-SHA1 알고리즘을 이용하여 URL 과 URL 서명 비밀번호 또는 Crypto Key 를 결합해 Digital Signature 를 생성합니다.
구글에서는 해당 알고리즘을 파이썬, 자바 등의 언어로 제공하고 있습니다.
※ 참조 URL
https://developers.google.com/maps/documentation/maps-static/get-api-key#sample-code-for-url-signing
A
무엇을 도와드릴까요?
(주)SPH는 Google Cloud의 국내 Premier Partner로서 Google Maps의 Exclusive 파트너로서 다양한 사례와 자료를 보유하고 있습니다.
보다 자세한 내용을 원하시는 분께서는 오른쪽 버튼을 통하여 문의해주시기 바랍니다.