iOS용 Maps SDK: API 키 가져오기

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

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

API 키 만들기

프로젝트에 연결된 API 키가 하나 이상 있어야 합니다.

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

  1. Google Cloud Platform Console로 이동합니다.
  2. 프로젝트 드롭다운을 클릭하고 프리미엄 플랜을 구매할 때 생성된 프로젝트를 선택합니다. 프로젝트 이름은 Google Maps APIs for Business나 Google Maps for Work 또는 Google Maps로 시작합니다.
  3. 참고: 플랜의 모든 기능을 이용하려면 프리미엄 고객은 프리미엄 계정과 연결된 프로젝트를 사용해야 합니다. 라이선스를 구매할 때 프리미엄 애셋의 이름이 gme-[company] & proj-[number] ([type]) 형식으로 제공됩니다. 올바른 프로젝트에 액세스하고 있는지 확인하려면 console.cloud.google.com/project/number를 사용하여 프로젝트 소유자로 콘솔에 로그인하세요 (number를 프로젝트 번호로 바꾸세요). 프로젝트 소유자는 환영 메일에서 찾을 수 있습니다.

  4. 메뉴 버튼 을 클릭하고 API 및 서비스 > 사용자 인증 정보를 선택합니다.
  5. 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 > API 키를 클릭합니다.
    API 키 생성 완료 대화상자에 새로 생성된 API 키(암호화된 문자열)가 표시됩니다.
  6. 닫기를 클릭합니다.
    새 API 키는 사용자 인증 정보 페이지의 API 키 아래 나열됩니다.

앱에 API 키 추가

다음 예에서 YOUR_API_KEY를 API 키로 바꾸세요.

Swift

다음과 같이 API 키를 AppDelegate.swift에 추가합니다.

  1. 다음 import 문을 추가합니다.
    import GoogleMaps
  2. 다음을 application(_:didFinishLaunchingWithOptions:) 메서드에 추가하여 YOUR_API_KEY를 본인의 API 키로 대체합니다.
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Places API도 사용 중이라면 여기에 표시된 것처럼 키를 다시 추가합니다.
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

다음과 같이 API 키를 AppDelegate.m에 추가합니다.

  1. 다음 import 문을 추가합니다.
    @import GoogleMaps;
  2. 다음을 application:didFinishLaunchingWithOptions: 메서드에 추가하여 YOUR_API_KEY를 본인의 API 키로 대체합니다.
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Places API도 사용 중이라면 여기에 표시된 것처럼 키를 다시 추가합니다.
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

API 키 제한

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

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

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

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

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

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

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