Package google.maps.navconnect.v1

색인

• NavConnectService(인터페이스)
• AuthToken(메시지)
• CreateTripRequest(메시지)
• GetTripRequest(메시지)
• Location(메시지)
• Stop(메시지)
• Trip(메시지)
• Trip.State(열거형)
• TripConfig(메시지)
• TripExecution(메시지)

NavConnectService

NavConnect 클라이언트가 여정을 만들고 가져오는 서비스입니다.

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) 여행을 만듭니다. 이 메서드는 모바일 애플리케이션이 이동을 시작하기 전에 호출해야 합니다. 반환된 여정에는 auth_token 필드가 설정되어 있습니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) 여행을 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform

AuthToken

인증 토큰입니다.

필드
token	string 출력 전용입니다. 모바일 애플리케이션에 전달되어야 하는 인증 토큰입니다.
expire_time	Timestamp 출력 전용입니다. 인증 토큰이 만료되는 시간입니다.

CreateTripRequest

NavConnectService.CreateTrip의 요청 메시지입니다.

필드
parent	string 필수 항목입니다. 이 여정이 생성될 상위 리소스입니다. 형식: projects/{project_number}
trip_id	string 필수 항목입니다. 여정에 사용할 ID이며, 여정의 리소스 이름의 마지막 구성요소가 됩니다. 이 값은 유효한 RFC-4122 UUID여야 합니다.
trip	Trip 필수 항목입니다. 만들 여행입니다.

GetTripRequest

NavConnectService.GetTrip 요청 메시지입니다.

필드
name	string 필수 항목입니다. 가져올 여행의 리소스 이름입니다. 형식: projects/{project}/trips/{trip_id}

위치

모바일 애플리케이션에서 보고한 위치입니다.

필드
point	LatLng 출력 전용입니다. 위치 위도/경도입니다.
source_time	Timestamp 출력 전용입니다. 클라이언트가 표시한 위치가 제공된 시간입니다.
server_time	Timestamp 출력 전용입니다. 서버가 이 위치 업데이트를 수신한 시간입니다.

중지

일부 작업을 수행해야 하는 여정의 정류장입니다.

필드
point	LatLng 필수 항목입니다. 정류장의 위치(위도/경도)입니다.

여행경로

여행

필드
name	string 출력 전용입니다. 식별자. 여행의 리소스 이름입니다. 형식: projects/{project_number}/trips/{trip_id}
config	TripConfig 변경할 수 없습니다. 여행의 구성입니다.
android_app_id	string 입력 전용입니다. 변경할 수 없습니다. 여행을 사용할 모바일 애플리케이션의 Android 애플리케이션 ID입니다. android_app_id 또는 ios_app_id 중 하나 이상을 설정해야 합니다.
ios_app_id	string 입력 전용입니다. 변경할 수 없습니다. 이 여정을 사용할 모바일 애플리케이션의 iOS 번들 ID입니다. android_app_id 또는 ios_app_id 중 하나 이상을 설정해야 합니다.
auth_token	AuthToken 출력 전용입니다. Google 지도 또는 Waze에서 NavConnect 이동을 시작할 수 있는 액세스 권한을 부여하고 이러한 애플리케이션에 이동을 업데이트할 수 있는 액세스 권한을 부여하는 불투명 토큰입니다. CreateTrip에서만 반환됩니다.
state	State 출력 전용입니다. 여행 상태입니다.
execution	TripExecution 출력 전용입니다. 이동 실행에 관한 최신 데이터입니다. 여행이 오류 상태인 경우 설정되지 않을 수 있습니다.
create_time	Timestamp 출력 전용입니다. 여행이 생성된 서버 시간입니다.
update_time	Timestamp 출력 전용입니다. 서버가 최신 이동 업데이트를 수신한 시간입니다.

주

가능한 모든 여행 상태입니다.

열거형
STATE_UNSPECIFIED	여행 상태가 지정되지 않았습니다.
NEW	여행이 생성되었지만 아직 시작되지 않았습니다.
ENROUTE	운송업체가 목적지로 이동 중입니다.
ARRIVED	운송업체가 목적지에 도착했습니다.
SUSPENDED	이동이 정지되었습니다.
FAILED	이동을 완료할 수 없습니다.
CLIENT_ERROR	클라이언트 오류로 인해 여정이 실패했습니다.

TripConfig

여행 구성입니다.

필드
enable_high_frequency_updates	bool 선택사항입니다. 고빈도 이동 업데이트를 사용 설정할지 여부입니다. 참고: 이 기능을 사용 설정하면 Enterprise 등급 사용량에 따라 이동이 기록되며 Enterprise 등급 요금이 적용됩니다.
enable_pubsub	bool 선택사항입니다. 여행에 Pubsub 알림을 사용 설정할지 여부입니다.
pubsub_field_mask	FieldMask 선택사항입니다. 설정된 경우 지정된 이동 필드의 하위 집합만 Pub/Sub 알림에 포함됩니다. 설정하지 않으면 모든 여행 필드가 Pub/Sub 알림에 포함됩니다 (기본 동작). 다음 필드는 지원되지 않습니다. android_app_id ios_app_id auth_token config 참고: enable_pubsub이 false이면 이 필드는 무시됩니다.

TripExecution

이동 실행에 관한 데이터입니다.

필드
origin	Location 출력 전용입니다. 이동의 출발지입니다. 일반적으로 NavConnect 이동 시작 시 운송업체의 위치입니다.
destination	Stop 출력 전용입니다. 모바일 애플리케이션에서 보고한 여행의 목적지입니다.
location	Location 출력 전용입니다. 운송업체의 마지막으로 알려진 위치를 나타내는 위치 신호입니다. 사용 가능한 경우 스냅된 도로 위치입니다.
traveled_duration	Duration 출력 전용입니다. 지금까지 이동한 시간입니다.
remaining_duration	Duration 출력 전용입니다. Google에서 추정한 이 여정의 남은 시간입니다.
traveled_distance_meters	int32 출력 전용입니다. 원점에서 이동한 거리(미터)입니다.
remaining_distance_meters	int32 출력 전용입니다. 목적지까지 남은 거리(미터)입니다.
stop_added_in_route	bool 출력 전용입니다. 경로에 경유지가 추가되었는지 여부를 나타냅니다.