Navigation Connect 설정

유럽 경제 지역 (EEA) 개발자

이 문서에서는 Navigation Connect를 사용하기 위해 필요한 단계를 설명합니다.

기본 요건

이 가이드에서는 결제가 사용 설정된 Google Cloud 계정과 Google Cloud 프로젝트를 설정하는 방법을 보여줍니다. Navigation Connect API 사용에 대한 요금 청구 방식도 숙지해야 합니다.

  1. Navigation Connect 사용량 및 청구에서 사용량에 대한 청구 및 비용을 검토합니다.
  2. Google Cloud 계정이 있는지 확인합니다.

    Google Cloud 콘솔에 로그인
  3. 결제가 사용 설정된 Google Cloud 프로젝트가 있는지 확인합니다.

    결제 페이지로 이동
    1. 프로젝트를 선택하여 결제 페이지를 엽니다.
    2. 결제 페이지에서 다음을 수행합니다.

      • 선택한 프로젝트에 결제가 이미 사용 설정되어 있고 결제 계정이 하나만 있는 경우 결제 페이지가 열립니다.
      • 결제 계정이 여러 개인 경우 연결된 결제 계정으로 이동을 선택하여 프로젝트와 연결된 결제 계정에 대한 세부정보를 확인합니다.
      • 결제 계정이 있지만 프로젝트와 연결되어 있지 않으면 결제 계정을 프로젝트에 연결하라는 메시지가 표시됩니다.
      • 결제 계정이 없거나 새 결제 계정을 만들려면 결제 계정 관리를 선택하여 새 결제 계정을 만듭니다. 자세한 내용은 새 셀프 서비스 Cloud Billing 계정 만들기를 참조하세요.

API 사용 설정 및 앱 확인

이 가이드에서는 Navigation Connect API를 사용 설정하고 Google Cloud 콘솔에서 앱을 인증하는 프로세스를 설명합니다. 이를 통해 앱이 Google 지도 및 Waze와 안전하게 상호작용할 수 있습니다. Navigation Connect API를 사용하려면 이 절차를 완료해야 합니다.

1. Navigation Connect API 사용 설정

Google Cloud 콘솔 또는 gcloud 명령어를 사용하여 Google Cloud 프로젝트에서 Navigation Connect API를 사용 설정합니다.

API를 사용 설정하려면 다음 단계를 수행합니다.

콘솔

  1. Google Cloud 콘솔에서 제품 페이지를 엽니다.

    Navigation Connect API 사용 설정
  2. 사용 설정 버튼을 클릭합니다.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

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

2. 앱 인증 절차 시작

API를 사용 설정한 후 앱을 인증하여 Navigation Connect API를 활성화해야 합니다. API를 사용 설정하는 것만으로는 액세스 권한이 부여되지 않습니다. Navigation Connect API를 사용하려면 먼저 비즈니스 및 앱 세부정보를 제공하여 검토를 받아야 합니다.

인증 절차를 시작하려면 다음 방법 중 하나를 사용하세요.

  • API 마켓플레이스:
    1. API 마켓플레이스에서 Navigation Connect API 카드를 찾습니다.
    2. 파란색 인증 필요 아이콘을 클릭하여 인증 절차를 시작합니다.
  • Google Cloud 콘솔의 키 및 사용자 인증 정보:
    1. Google Cloud 콘솔에서 키 및 사용자 인증 정보 페이지로 이동합니다.
    2. 탐색 연결 키 및 사용자 인증 정보를 클릭합니다.
    3. 배너에서 인증 시작을 클릭합니다.

3. 앱, 데이터 수집, 개인 정보 보호 세부정보 제공

다음 표에서는 앱 인증을 위해 제공해야 하는 세부정보를 설명합니다.

필드 설명
앱 세부정보

앱이 Google 지도 및 Waze에 올바르게 표시되도록 다음 세부정보를 제공하세요.

비즈니스 또는 앱 이름 Google 지도 및 Waze에서 사용자에게 표시할 이름을 입력합니다.
애플리케이션 식별자 Android 패키지 이름 또는 iOS 번들 ID를 입력합니다.
iOS 범용 링크 사용자가 앱으로 돌아갈 수 있는 iOS 범용 링크를 제공합니다 (Waze에서만 사용 가능).
앱 로고 (Waze만 해당) (선택사항) PNG 또는 JPG 로고 (32x32~128x128픽셀)를 업로드하여 내비게이션 세션 중에 Waze에 앱 로고를 표시합니다.
데이터 수집 및 개인 정보 보호 세부정보

투명성, 운전자 신뢰, 데이터 보안을 위해 다음 세부정보를 입력하세요.

개인정보처리방침 링크 앱의 개인정보처리방침 URL을 제공합니다. 이 링크는 동의 화면에 표시됩니다.
추가 데이터 컨트롤러 (선택사항) ISV와 같은 서드 파티 데이터 관리자의 상호와 개인정보처리방침 링크를 제공합니다. 이 세부정보는 동의 화면에 표시됩니다.
데이터 규정 준수 앱이 미국에서 운영되는 경우 이 앱은 미국에서 발생하는 이동에 사용됩니다 체크박스를 선택하여 현지 규정을 준수합니다.

4. 검토 후 제출

인증을 위해 앱을 제출하기 전에 제공한 정보의 요약을 검토합니다.

  1. 앱 이름, 플랫폼, ID, 링크를 신중하게 검토합니다.

  2. 모든 정보가 정확함 체크박스를 선택합니다.
  3. 제출을 클릭합니다.

확인을 위해 앱을 제출하면 검토 단계가 시작됩니다.

  • 일정: 인증에는 일반적으로 영업일 기준 1~3일이 소요됩니다.
  • 알림: 인증 상태가 변경되면 이메일이 전송됩니다. 결제 프로필 ID 또는 Android 개발자 ID를 요청하는 이메일도 받게 됩니다. Android 개발자 ID가 필요한 경우 개발자 계정 만들기를 참고하세요.
  • 상태 추적: Google Cloud 콘솔의 키 및 사용자 인증 정보 페이지에서 진행 상황을 모니터링합니다.
  • 지원: 승인 후 프로덕션에 영향을 주지 않고 구성을 업데이트하려면 지원 티켓을 만드세요.

인증이 완료되면 앱에서 Navigation Connect API를 사용하여 이동 토큰을 생성할 수 있습니다. 이 토큰은 내비게이션 세션에 대한 액세스를 승인하고 Google 지도 및 Waze에서 이동 세부정보를 수신할 수 있도록 합니다.

Google Maps Platform 제품은 무단 사용을 방지하기 위해 API 호출에 OAuth 토큰을 포함해야 합니다.

OAuth 토큰 만들기

Navigation Connect는 인증에 OAuth 2.0을 지원합니다. Google은 웹 서버 시나리오와 같은 일반적인 OAuth 2.0 시나리오를 지원합니다.

이 문서에서는 개발 환경에서 Navigation Connect 호출에 OAuth 토큰을 전달하는 방법을 설명합니다. 프로덕션 환경에서 OAuth를 사용하는 방법에 대한 자세한 내용은 Google의 인증 방법을 참조하세요.

서버에 API 요청을 수행하여 Google 지도 API를 직접 호출하거나 클라이언트 라이브러리를 사용하여 코드를 간소화할 수 있습니다. Google 지도는 Go, Java, Node.js, Python용 클라이언트 라이브러리를 제공합니다. 자세한 내용은 Navigation Connect 클라이언트 라이브러리를 참고하세요.

OAuth 개요

배포 환경에 따라 여러 가지 방법으로 OAuth를 사용하여 액세스 토큰을 만들고 관리할 수 있습니다.

애플리케이션과 Google 서비스 간의 서버 간 상호작용에 OAuth 2.0을 사용할 수 있습니다. 이 시나리오에서는 개별 사용자가 아닌 애플리케이션과 연결된 서비스 계정을 사용합니다. 사용자를 직접 개입시키지 않고 서비스 계정을 사용하여 API 요청을 수행할 수 있습니다. 인증 방법에 대한 자세한 내용은 Google 인증 방법을 참조하세요.

또는 Navigation Connect를 Android 또는 iOS 모바일 앱에 통합할 수 있습니다. 다양한 배포 환경에서 OAuth를 사용하고 액세스 토큰을 관리하는 방법에 관한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스를 참고하세요.

OAuth 범위

Navigation Connect에서 OAuth를 사용하려면 OAuth 토큰에 다음 범위를 할당해야 합니다.

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

예시: 로컬 개발 환경에서 REST API 호출 사용해 보기

토큰을 생성하는 환경이 없고 OAuth 토큰으로 Navigation Connect를 사용해 보려면 이 섹션의 절차를 따르세요.

이 예시에서는 애플리케이션 기본 사용자 인증 정보 (ADC)에서 제공하는 OAuth 토큰을 사용하여 호출하는 방법을 설명합니다. ADC를 사용하고 클라이언트 라이브러리를 사용하여 Google API를 호출하는 방법은 클라이언트를 사용하여 인증을 참조하세요.

다음 REST 절차는 개발 또는 테스트에만 사용하고 프로덕션에는 사용하지 마세요.

기본 요건

ADC를 사용하여 REST 요청을 수행하기 전에 gcloud CLI를 사용하여 ADC에 사용자 인증 정보를 제공합니다.

  1. gcloud CLI를 설치하고 초기화합니다. 자세한 내용은 gcloud CLI 설치를 참조하세요.

  2. gcloud CLI로 인증합니다.

    gcloud auth application-default login
  3. 로그인 프로세스를 완료하여 사용자 인증 정보를 ADC에서 사용하는 로컬 사용자 인증 정보 파일에 저장합니다.

자세한 내용은 로컬 개발 환경의 ADC 설정을 참조하세요.

REST 요청 수행

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

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

    gcloud auth application-default print-access-token

    반환된 토큰의 범위는 https://www.googleapis.com/auth/cloud-platform입니다.

  • X-Goog-User-Project 헤더에서 결제가 사용 설정된 Google Cloud 프로젝트의 ID 또는 이름을 전달합니다.

OAuth 토큰을 사용하여 Navigation Connect를 호출하려면 다음 단계를 완료하세요.

  1. 다음 코드 샘플에서 자리표시자를 원하는 값으로 바꿉니다.

    • PROJECT_ID: Google Cloud 프로젝트 ID입니다.
    • ANDROID_APP_ID: 앱의 Android 패키지 이름(해당하는 경우)
    • IOS_APP_ID: 앱의 iOS 번들 ID(해당하는 경우)
    #!/bin/bash
    trip_id="$(uuidgen)"
    access_token="$(gcloud auth application-default print-access-token)"
    curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
    -H "Authorization: Bearer ${access_token}" \
    -H "Content-Type: application/json" \
    -d '{
    "androidAppId": "ANDROID_APP_ID",
    "iosAppId": "IOS_APP_ID",
    }'
  2. curl 명령어를 복사하려면 코드 샘플에서 복사를 클릭합니다.

  3. 터미널 창에 명령어를 붙여넣은 후 실행합니다.

응답은 JSON 객체입니다.

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

이 응답에는 다음 값이 포함됩니다.

  • PROJECT_NUMBER: 프로젝트의 고유한 긴 정수 식별자입니다.
  • TRIP_ID: 백엔드에서 생성하는 UUIDv4 이동 ID
  • BASE64_ENCODED_TRIP_TOKEN: Google 지도 또는 Waze에서 추적된 세부 경로 안내 내비게이션을 시작하기 위해 createTrip 메서드가 반환하는 인증된 토큰입니다.

문제 해결

요청이 이 API에서 최종 사용자 인증 정보를 지원하지 않는다는 오류 메시지를 반환하는 경우 ADC 설정 문제 해결을 참조하세요.

다음 단계

다음으로, 백엔드 인프라, Google 지도, Waze 간의 안전한 서버 간 통신을 지원하도록 Navigation Connect API의 서비스 계정을 구성합니다.

서비스 계정 설정