Distance Matrix API (기존)에 API 키 사용

Google은 API 호출을 적절한 사용자 인증 정보를 제공하는 API 호출로 제한하여 무단 사용으로부터 Google Maps Platform 제품을 보호합니다. 이러한 사용자 인증 정보는 Cloud Billing 계정을 프로젝트, 특정 API나 SDK와 연결하는 고유한 영숫자 문자열인 API 키 형태입니다.

이 가이드에서는 Google Maps Platform에서 API 키를 생성, 제한 및 사용하는 방법을 설명합니다.

시작하기 전에

Distance Matrix API (기존)를 사용하려면 결제 계정이 있고 Distance Matrix API (기존)가 사용 설정된 프로젝트가 필요합니다. 자세한 내용은 Cloud 콘솔에서 설정하기를 참고하세요.

API 키 만들기

API 키는 사용 및 결제 목적으로 프로젝트와 관련된 요청을 인증하는 고유 식별자입니다. 프로젝트에 연결된 API 키가 하나 이상 있어야 합니다. 새 키를 만들거나 기존 키에 API 또는 SDK를 추가하려면 다음 안내를 따르세요.

콘솔

  1. Google Maps Platform > 키 및 사용자 인증 정보 페이지로 이동합니다.

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

  2. 메시지가 나타나면 프로젝트를 선택합니다.

  3. 다음 중 하나를 수행합니다.

    • 새 키 만들기:

      1. 사용자 인증 정보 만들기 > API 키를 클릭합니다.
      2. API 키 만들기 패널에서 API 제한사항 선택 목록을 엽니다.
      3. 이 키에 필요하지 않은 API를 모두 지우고 Distance Matrix API가 선택된 상태로 유지되는지 확인합니다.
      4. 만들기를 클릭합니다. 패널에 새 API 키가 표시됩니다.

    • 기존 키 사용:

      1. 키 이름을 클릭합니다.
      2. API 제한사항 선택 목록에서 Distance Matrix API를 선택합니다.
      3. 저장을 클릭합니다.

    여기에서 API를 선택해도 사용 설정되지 않습니다. API 라이브러리 페이지에서 Distance Matrix API가 사용 설정되어 있는지 확인합니다.

  4. 나중에 키 문자열을 보려면 키 및 사용자 인증 정보 페이지로 이동하여 키의 키 표시를 클릭합니다.

콘솔이 이 단계와 다르게 표시되면 Google Cloud 문서의 API 키 만들기 및 API 제한사항 추가를 참고하세요.

gcloud

다음 명령어에서 PROJECT_ID를 프로젝트 ID로 바꿉니다.

  • 새 키 만들기: 다음 명령어를 실행하고 DISPLAY_NAME를 키 이름으로 바꿉니다. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=distance-matrix-backend.googleapis.com

    Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

  • 기존 키 사용: 다음 명령어를 실행하고 KEY_ID를 키 ID로 바꿉니다. --append 플래그는 키가 이미 허용하는 API를 유지합니다. 이 플래그가 없으면 명령어가 이를 대체합니다.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=distance-matrix-backend.googleapis.com

    Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

    키 ID는 키 문자열 또는 표시 이름이 아닙니다. 이를 찾으려면 gcloud services api-keys list --project="PROJECT_ID"를 실행합니다. ID는 name 필드의 마지막 부분입니다. projects/PROJECT_NUMBER/locations/global/keys/KEY_ID

키 문자열을 보려면 gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID"를 실행합니다.

API 키 제한

API 키를 애플리케이션에 필요한 API에서만 사용하도록 제한하는 것이 좋습니다. API 키를 제한하면 불필요한 요청으로부터 애플리케이션이 보호되어 애플리케이션의 보안이 강화됩니다. 제한되지 않은 API 키의 악용으로 인해 발생하는 비용에 대한 재정적 책임은 사용자에게 있습니다. 자세한 내용은 API 보안 권장사항을 참고하세요.

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

콘솔

  1. Google Maps Platform > 키 및 사용자 인증 정보 페이지로 이동합니다.

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

  2. 제한을 설정할 API 키를 선택합니다. API 키 속성 페이지가 나타납니다.
  3. 키 제한사항에서 다음 제한사항을 설정합니다.
    • 애플리케이션 제한:
      1. 제공하는 웹 서버 IP 주소 목록에서 요청을 수락하려면 애플리케이션 제한사항에서 IP 주소를 선택합니다. CIDR 표기법을 사용하여 IPv4 또는 IPv6 주소 하나 이상 또는 서브넷 하나를 지정합니다. IP 주소는 Google Maps Platform 서버에서 관찰하는 소스 주소와 일치해야 합니다. 네트워크 주소 변환 (NAT)을 사용하는 경우 일반적으로 시스템의 공개 IP 주소에 해당합니다.
    • API 제한:
      1. API 제한사항 선택에서 Distance Matrix API가 선택되어 있는지 확인합니다. 표시되지 않으면 사용 설정해야 합니다.
  4. 변경을 완료하려면 저장을 클릭합니다.

gcloud

다음 명령어를 실행합니다. KEY_ID를 키 ID로 바꾸고 PROJECT_ID를 프로젝트 ID로 바꿉니다. 키 ID를 찾으려면 gcloud services api-keys list --project="PROJECT_ID"를 실행합니다. ID는 name 필드의 마지막 부분입니다.

gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=distance-matrix-backend.googleapis.com \
    --allowed-ips="IP_ADDRESS"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

요청에 API 키 추가

모든 Distance Matrix API (기존) 요청에 API 키를 포함해야 합니다. 다음 예에서 YOUR_API_KEY를 API 키로 바꿉니다.

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY

API 키를 사용하는 요청에는 HTTPS를 사용해야 합니다.