Geolocation API: API 키 가져오기

참고: Google Maps Platform 프리미엄 플랜은 신규 가입이 불가능하며 신규 고객에게 제공되지 않습니다.

Geolocation API를 사용하려면 API 키를 사용하여 요청을 인증해야 합니다. API 키를 사용하여 다음을 수행할 수 있습니다.

자세한 내용은 프리미엄 플랜 고객이 사용할 수 있는 보고서를 참고하세요.

API 키 만들기

Geolocation API를 사용하려면 API 키가 있어야 합니다. API 키는 사용 및 결제 목적으로 프로젝트와 관련된 요청을 인증하는 데 사용되는 고유 식별자입니다.

API 키를 가져오는 방법은 다음과 같습니다.

  1. GCP Console의 프로젝트 선택기 페이지에서 API 키를 추가할 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

    참고: 플랜의 모든 기능을 이용하려면 프리미엄 고객은 프리미엄 계정과 연결된 프로젝트를 사용해야 합니다. 라이선스를 구매할 때 프리미엄 애셋의 이름이 gme-[company] & proj-[number] ([type]) 형식으로 제공되었습니다. 올바른 프로젝트에 액세스하고 있는지 확인하려면 console.cloud.google.com/project/number를 사용하여 프로젝트 소유자로 콘솔에 로그인하세요(number를 프로젝트 번호로 바꾸세요). 프로젝트 소유자는 환영 메일에서 찾을 수 있습니다.

  2. API 및 서비스 > 사용자 인증 정보 페이지로 이동합니다.

    사용자 인증 정보 페이지로 이동

  3. 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 > API 키를 클릭합니다.
    API 키 생성 완료 대화상자에 새로 만든 API 키가 표시됩니다.
  4. 닫기를 클릭합니다.
    새 API 키는 사용자 인증 정보 페이지의 API 키 아래 나열됩니다.
    (프로덕션에 사용하기 전에 API 키를 제한하세요.)

요청에 API 키 추가

모든 Geolocation API 요청에 API 키를 포함해야 합니다. 다음 예시에서 YOUR_API_KEY를 API 키로 바꿉니다.

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

API 키 제한

API 키를 제한하면 승인된 요청만 API 키로 실행되기 때문에 애플리케이션 보안이 강화됩니다. 안내에 따라 API 키에 대한 제한을 설정하시기 바랍니다. 자세한 내용은 API 키 권장사항을 참고하세요.

API 키를 제한하는 방법은 다음과 같습니다.

  1. GCP Console의 프로젝트 선택기 페이지에서 API 키를 추가할 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  2. API 및 서비스 > 사용자 인증 정보 페이지로 이동합니다.

    사용자 인증 정보 페이지로 이동

  3. 제한을 설정할 API 키를 선택합니다. API 키 속성 페이지가 나타납니다.
  4. 키 제한사항에서 다음 제한사항을 설정합니다.
    • 애플리케이션 제한:
      1. 제공하는 웹 서버 IP 주소 목록에서 요청을 수락하려면 애플리케이션 제한사항 목록에서 IP 주소(웹 서버, 크론 작업 등)를 선택합니다.
      2. CIDR 표기법(예: 192.168.0.0/22)을 사용하여 IPv4나 IPv6 주소 하나 또는 서브넷을 지정합니다. 다른 항목을 입력해야 하는 경우 이전 항목을 추가한 후 새 상자가 표시됩니다.
    • API 제한:
      1. 키 제한을 클릭합니다.
      2. API 선택 드롭다운에서 Geolocation API를 선택합니다.
        (Geolocation API가 표시되지 않으면 사용 설정해야 합니다.)
  5. 변경사항을 완료하려면 저장을 클릭합니다.

인증 문제 해결

요청의 형식이 잘못되었거나 잘못된 서명이 포함된 경우 Geolocation API에서 HTTP 403 (Forbidden) 오류를 반환합니다.

개별 URL의 문제를 해결하려면 URL 서명 디버거를 사용하세요. 이 도구를 사용하면 애플리케이션이 생성한 URL과 서명의 유효성을 신속하게 검사할 수 있습니다.

또는 프리미엄 플랜 고객의 경우 Google Cloud 지원 포털에 로그인하고 리소스 > Google Maps Platform 프리미엄 플랜 온라인 도구 > 웹 서비스 및 이미지 API용 URL 서명 디버거를 선택하여 개별 URL의 문제를 해결할 수 있습니다.