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

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

OAuth 사용

Map Tiles API는 인증을 위한 OAuth 2.0 사용을 지원합니다. Google은 웹 서버와 같은 일반적인 OAuth 2.0 시나리오를 지원합니다.

이 문서에서는 OAuth 토큰을 개발 환경에 따라 다릅니다. OAuth를 사용하는 방법에 대한 안내는 프로덕션 환경에 대한 자세한 내용은 Google의 인증.

시작하기 전에

Map Tiles API를 사용하려면 먼저 결제 계정이 있고 Map Tiles API가 사용 설정된 프로젝트. 여러 개의 프로젝트 소유자 및 결제 관리자(이 역할을 맡은 담당자가 항상 존재함) 사용할 수 있습니다 자세한 내용은 Cloud Console에서 설정하기를 참고하세요.

OAuth 정보

배포에 따라 다양한 방법으로 OAuth로 액세스 토큰을 만들고 관리할 수 있습니다. 환경입니다

예를 들어, Google OAuth 2.0 시스템은 Google 서비스 간에 통신할 수 있습니다 이 시나리오에서는 은 개별 최종 사용자가 아니라 애플리케이션에 속한 계정입니다. 내 애플리케이션이 서비스 계정을 대신하여 Google API를 호출하므로 사용자가 직접 관여하지 않습니다. 인증 방법에 대한 자세한 내용은 다음을 참조하세요. Google에서의 인증

또는 Android 또는 iOS 모바일 앱의 일부로 Map Tiles API를 사용할 수도 있습니다. 관리 방법을 비롯하여 Map Tiles API에서 OAuth를 사용하는 방법에 대한 일반적인 정보는 다른 배포 환경에 대한 자세한 내용은 다음을 참조하세요. OAuth 2.0을 사용하여 Google API에 액세스하기

OAuth 범위 정보

Map Tiles API에서 OAuth를 사용하려면 OAuth 토큰에 범위를 할당해야 합니다.

https://www.googleapis.com/auth/cloud-platform

예: 로컬 개발 환경에서 REST API 호출 시도

OAuth 토큰을 사용하여 Map Tiles API를 사용해 보고 싶지만 환경이 없는 경우 토큰을 생성하도록 설정하려면 이 섹션의 절차에 따라 호출할 수 있습니다.

이 예에서는 애플리케이션 기본 사용자 인증 정보 (ADC) 전화를 겁니다. ADC를 사용하여 클라이언트 라이브러리로 Google API를 호출하는 방법에 대한 자세한 내용은 다음을 참조하세요. 클라이언트 라이브러리를 사용하여 인증

기본 요건

ADC를 사용하여 REST 요청을 하려면 먼저 Google Cloud CLI를 사용하세요. 를 사용하여 ADC에 사용자 인증 정보를 제공합니다.

아직 프로젝트를 만들지 않은 경우 다음 단계에 따라 프로젝트를 만들고 결제를 사용 설정합니다. Google Cloud 콘솔에서 설정
gcloud CLI를 설치하고 초기화합니다.
로컬 머신에서 다음 gcloud 명령어를 실행하여 사용자 인증 정보 파일:
```
gcloud auth application-default login
```
로그인 화면이 표시됩니다. 로그인한 후에는 사용자 인증 정보가 ADC에서 사용하는 로컬 사용자 인증 정보 파일.

자세한 내용은 로컬 개발 환경 섹션의 애플리케이션 기본 사용자 인증 정보에 대한 사용자 인증 정보 제공 문서를 참조하세요.

REST 요청

이 예에서는 두 개의 요청 헤더를 전달합니다.

다음을 사용하여 Authorization 헤더에 OAuth 토큰을 전달합니다. 명령어를 사용하여 토큰을 생성합니다.

gcloud auth application-default print-access-token

반환된 토큰의 범위는 https://www.googleapis.com/auth/cloud-platform.
다음에서 결제가 사용 설정된 Google Cloud 프로젝트의 ID 또는 이름을 X-Goog-User-Project 헤더. 자세한 내용은 Cloud 콘솔에서 설정합니다.

다음 예에서는 OAuth 토큰을 사용하여 Map Tiles API를 호출합니다.

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
"https://tile.googleapis.com/v1/createSession"

문제 해결

요청에서 이 API에서 지원하지 않는 최종 사용자 인증 정보에 대한 오류 메시지를 반환하는 경우 사용자 인증 정보가 작동하지 않음을 참고하세요.