Navigation SDK는 현재 일부 고객만 사용할 수 있습니다. 자세한 내용은 영업팀에 문의하세요.

새로운 지도 스타일 지정 기능이 곧 Google Maps Platform에 도입될 예정입니다. 이번 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트가 추가되었으며 지도 환경 및 사용성이 개선되었습니다. 모든 지도 스타일은 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 이전에 선택한 방법에 대한 자세한 내용은 Google Maps Platform의 새 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

API 키 사용

API 키 만들기

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

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

Console

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

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

Cloud SDK

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

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

gcloud alpha services api-keys create

API 키 제한

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

API 키를 제한하는 경우 애플리케이션에 서명하는 데 사용된 서명 키의 SHA-1 인증서 디지털 지문을 제공해야 합니다. 다음과 같은 두 가지 인증서 유형이 있습니다.

디버그 인증서: 테스트 중인 앱 및 기타 비프로덕션 코드에서만 이 인증서 유형을 사용합니다. 디버그 인증서로 서명된 앱은 게시하지 마세요. Android SDK 도구는 디버그 빌드를 실행할 때 이 인증서를 자동으로 생성합니다.
출시 인증서: 앱을 앱 스토어에 출시할 준비가 되면 이 인증서를 사용합니다. 출시 빌드를 실행하면 Android SDK 도구에서 이 인증서가 생성됩니다.

Android 애플리케이션 서명 및 인증서에 대한 자세한 내용은 앱 서명 가이드를 참고하세요.

서명 인증서 지문을 찾는 방법에 대한 지침은 아래 참고 자료를 확인하세요.

Play 앱 서명을 사용하고 있다면 API 제공업체와 협업하기를 참고하세요.
자체 서명 키를 관리하고 있다면 애플리케이션 자체 서명을 참고하거나 빌드 환경에 대한 안내를 참고하세요.

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

Console

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

사용자 인증 정보 페이지로 이동하기
제한을 설정할 API 키를 선택합니다. API 키 속성 페이지가 나타납니다.
키 제한사항에서 다음 제한사항을 설정합니다.

애플리케이션 제한:

Android 앱을 선택합니다.
+ 패키지 이름 및 디지털 지문 추가를 클릭합니다.
패키지 이름과 SHA-1 인증서 디지털 지문을 입력합니다. 예를 들면 다음과 같습니다.
```
com.example.android.mapexample
```
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
```

API 제한:

키 제한을 클릭합니다.
API 선택 드롭다운에서 Navigation SDK를 선택합니다. Navigation SDK가 표시되지 않으면 enable해야 합니다.

변경을 완료하려면 저장을 클릭합니다.

Cloud SDK

기존 키를 나열합니다.

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

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

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

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

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

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