Google 지도 또는 Waze에서 이동 데이터 업데이트를 수신하려면 다음 옵션 중 하나를 사용하여 백엔드를 구성하세요.
- Navigation Connect API를 사용하는 가져오기 메서드 또는
- Google Cloud Pub/Sub를 사용하는 이벤트 기반 푸시 메서드
옵션 1: Navigation Connect API 사용
최신 이동 상태를 수동으로 가져오려면 고유한 이동 ID를 사용하여 GetTrip 메서드를 호출합니다.
다음 샘플에서는 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용하여 명령줄에서 API를 호출하여 서버 간 요청을 승인하는 방법을 보여줍니다.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
다중선 형식 맞춤설정 (Waze만 해당)
이동을 만드는 동안 남은 경로 보고
를 사용 설정한 경우 반환된
남은 경로 다중선의 표현을 GetTrip 메서드를 호출할 때 맞춤설정할 수 있습니다.
다중선의 형식을 선택하려면 요청에 routePolylineFormat 매개변수를 포함합니다. 지원되는 형식은 다음과 같습니다.
ENCODED: 표준 인코딩된 다중선 문자열 (소수점 5자리)S2ENCODED: 인코딩된 S2PolylineGEO_JSON: GeoJSON LineString 형식
옵션 2: Google Cloud Pub/Sub 사용
정기적인 이동 업데이트를 수신하려면 Google Cloud Pub/Sub 주제를 구독하세요. 운전자가 동의하면 Navigation Connect에서 업데이트를 주제로 직접 전송합니다.
메시징에 관한 소개는 Pub/Sub 빠른 시작을 참조하세요.
다음 섹션에서는 Google Cloud Pub/Sub를 사용하여 Google 지도 또는 Waze의 내비게이션 세션에서 데이터를 수신하는 방법을 설명합니다.
1. 주제 만들기
다음과 같이 Google Cloud 프로젝트에서 정확히 navigation_connect_trip_notifications라는 주제를 만듭니다.
- Pub/Sub API를 사용 설정합니다.
- Pub/Sub 주제 페이지 Google Cloud 콘솔에서 이동합니다.
- 주제 만들기 를 클릭합니다.
주제 ID 필드에
navigation_connect_trip_notifications를 입력합니다.만들기 를 클릭합니다.
콘솔에 전체 주제 이름이 projects/project-number/topics/navigation_connect_trip_notifications로 표시됩니다. 여기서 project-number는 고유한 프로젝트 번호입니다.
2. Navigation Connect 서비스 계정에 게시 권한 부여
Google은 서비스 계정을 사용하여 이동 업데이트를 Google Cloud Pub/Sub 주제에 게시합니다. 주제에서 업데이트를 수신하려면 다음 서비스 계정에 이 주제에 대한 projects.topics.publish 권한을 부여하세요. geo-navigation-connect-pubsub@system.gserviceaccount.com
자세한 내용은 액세스 제어에 관한 Pub/Sub 문서를 참조하세요 .
3. 백엔드와 통합
업데이트를 처리하려면 주제를 인증하고 구독하는 서버 측 애플리케이션을 작성합니다. 간소화된 개발을 위해 Pub/Sub 클라이언트 라이브러리 를 사용하세요. 테스트를 위해 GCloud CLI 및 Google 콘솔을 사용할 수도 있습니다.
4. 구독 테스트
gcloud CLI 또는 Google Cloud 콘솔을 사용하여 설정을 확인합니다.
gcloud CLI
다음 명령어를 사용하여 구독 (예: my-sub)에서 메시지를 가져옵니다.
gcloud pubsub subscriptions pull my-sub --auto-ack
Google Cloud 콘솔
Google Cloud 콘솔에서 다음 단계를 수행합니다.
- 구독 페이지를 엽니다.
- 구독을 선택하고 메시지 탭을 클릭합니다.
- 가져오기 를 클릭합니다.
다음 단계
이동 데이터 수신을 시작하면 데이터를 파싱하여 시스템 및 앱에서 사용합니다.