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: 인코딩된 S2Polyline입니다.GEO_JSON: GeoJSON LineString 형식입니다.
옵션 2: Google Cloud Pub/Sub 사용
정기적인 여정 업데이트를 받으려면 Google Cloud Pub/Sub 주제를 구독하세요. 운전자가 동의하면 내비게이션 커넥트에서 업데이트를 주제로 직접 전송합니다.
메시지에 대한 소개는 Pub/Sub 빠른 시작을 참고하세요.
다음 섹션에서는 Google Cloud Pub/Sub을 사용하여 Google 지도 또는 Waze의 탐색 세션에서 데이터를 수신하는 방법을 설명합니다.
1. 주제 만들기
다음과 같이 Google Cloud 프로젝트에서 정확히 navigation_connect_trip_notifications이라는 주제를 만듭니다.
- Pub/Sub API를 사용 설정합니다.
- Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.
- 주제 만들기를 클릭합니다.
주제 ID 필드에
navigation_connect_trip_notifications를 입력합니다.만들기를 클릭합니다.
콘솔에 전체 주제 이름이 projects/project-number/topics/navigation_connect_trip_notifications로 표시됩니다. 여기서 project-number은 고유한 프로젝트 번호입니다.
2. 탐색 연결 서비스 계정에 게시 권한 부여
Google은 서비스 계정을 사용하여 Google Cloud Pub/Sub 주제에 이동 업데이트를 게시합니다. 주제에서 업데이트를 수신하려면 다음 서비스 계정(geo-navigation-connect-pubsub@system.gserviceaccount.com)에 이 주제에 대한 projects.topics.publish 권한을 부여하세요.
자세한 내용은 액세스 제어에 관한 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 콘솔에서 다음 단계를 수행합니다.
- 구독 페이지를 엽니다.
- 구독을 선택하고 메시지 탭을 클릭합니다.
- 가져오기를 클릭합니다.
다음 단계
이동 데이터를 수신하기 시작하면 데이터를 파싱하여 시스템과 앱에서 사용합니다.