API 키 가져오기

플랫폼 선택: Android iOS JavaScript

이제 결제 및 프로젝트를 설정하고 SDK를 사용 설정하고 선호하는 종속 항목 관리자 및 기타 소프트웨어를 설치했으므로 API 키를 만들고, 추가하고, 제한할 준비가 되었습니다.

API 키 만들기

API 키는 사용 및 결제에 관한 프로젝트와 관련된 요청을 인증하는 고유 식별자입니다. 프로젝트에 연결된 API 키가 하나 이상 있어야 합니다.

API 키를 만들려면 다음 단계를 따르세요.

콘솔

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

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

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

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

Xcode 프로젝트 설정에 설명된 대로 Xcode 프로젝트를 만들 때 이 API 키가 필요합니다.

API 키 제한

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

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

콘솔

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

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

  2. 제한을 설정할 API 키를 선택합니다. API 키 속성 페이지가 나타납니다.
  3. 키 제한사항에서 다음 제한사항을 설정합니다.
    • 애플리케이션 제한:
      1. iOS 앱을 선택합니다.
      2. 본인이 제공한 번들 식별자가 있는 iOS 앱에서 보내는 요청을 수락하려면 목록에서 적절한 iOS 번들 식별자를 선택합니다.
    • API 제한:
      1. 키 제한을 클릭합니다.
      2. API 선택 드롭다운에서 iOS용 Maps SDK를 선택합니다. iOS용 Maps SDK가 표시되지 않으면 사용 설정해야 합니다.
  4. 변경을 완료하려면 저장을 클릭합니다.

Cloud SDK

기존 키를 나열합니다. 

gcloud services api-keys list --project="PROJECT"

기존 키에 대한 기존 제한을 삭제합니다. 

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

기존 키에 새로운 제한을 설정합니다. 

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-ios-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

이제 iOS용 Maps SDK의 API 키를 받았으므로 시작할 수 있습니다.

다음 단계

이제 API 키가 있으므로 Xcode 프로젝트 설정에 설명된 대로 Xcode 프로젝트를 만들고 구성합니다.