Package google.maps.navconnect.v1

색인

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

NavConnectService

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

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) 여행을 생성합니다. 모바일 애플리케이션이 여행을 시작하기 전에 이 메서드를 호출해야 합니다. 반환된 여행에는 auth_token 필드가 설정됩니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform IAM 권한 parent 리소스에 대해서는 다음 IAM 권한이 필요합니다. navigationconnect.trips.create 자세한 내용은 IAM 문서를 참조하세요.

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) 여행을 가져옵니다. 승인 범위 다음 OAuth 범위가 필요합니다. https://www.googleapis.com/auth/cloud-platform IAM 권한 name 리소스에 대해서는 다음 IAM 권한이 필요합니다. navigationconnect.trips.get 자세한 내용은 IAM 문서를 참조하세요.

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}
route_polyline_format	RoutePolylineFormat 선택사항입니다. 반환할 경로 폴리라인의 형식입니다. 설정하지 않으면 SIMPLE 경로 다중선이 반환됩니다.

RoutePolylineFormat

경로 폴리라인의 형식을 지정합니다.

열거형
ROUTE_POLYLINE_FORMAT_UNSPECIFIED	경로 폴리라인 형식이 지정되지 않았습니다.
SIMPLE	경로 다중선은 google.type.LatLng로 표시된 점의 단순 배열로 반환됩니다.
ENCODED	경로 폴리라인은 인코딩된 문자열로 반환됩니다. https://developers.google.com/maps/documentation/utilities/polylinealgorithm을 참고하세요.
S2ENCODED	경로 다중선은 S2Polyline으로 인코딩됩니다. https://s2geometry.io/devguide/basic_types.html을 참고하세요.
GEO_JSON	경로 다중선은 GeoJSON LineString으로 반환됩니다. https://tools.ietf.org/html/rfc7946#section-3.1.4를 참고하세요.

위치

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

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

경로

경로 폴리라인입니다.

필드
traffic_information[]	SpeedReadingInterval 출력 전용입니다. 속도 읽기 간격으로 설명된 다중선의 교통 정보입니다. 참고: 간격이 겹치지 않습니다. 간격이 연속됩니다. 간격은 전체 폴리라인을 포함합니다. 인덱스가 증가하는 순서로 간격이 정렬됩니다. 속도는 각 인터벌에 대해 지정됩니다.
통합 필드 format. 경로 형식입니다. 채워지는 형식은 route_polyline_format 매개변수로 제어됩니다. 설정하지 않으면 기본값은 간단한 다중선입니다. format은 다음 중 하나여야 합니다.
simple_polyline	SimplePolyline 출력 전용입니다. 경로를 간단한 latlng 목록으로 나타냅니다.
encoded_polyline	string 출력 전용입니다. 인코딩된 다중선으로 표시된 경로입니다. https://developers.google.com/maps/documentation/utilities/polylinealgorithm을 참고하세요.
s2_polyline	bytes 출력 전용입니다. 인코딩된 S2Polyline으로 표시된 경로입니다. https://s2geometry.io/devguide/basic_types.html을 참고하세요.
geo_json	Struct 출력 전용입니다. GeoJSON LineString으로 표시된 경로입니다. https://tools.ietf.org/html/rfc7946#section-3.1.4를 참고하세요.

SimplePolyline

점의 단순 목록을 사용하여 다중선을 나타냅니다.

필드
points[]	LatLng 출력 전용입니다. 폴리라인을 나타내는 점의 순서가 지정된 목록입니다.

SpeedReadingInterval

경로의 연속된 구간에 있는 교통 밀도 표시기입니다. 점 P_0, P_1, ... , P_N (0부터 시작하는 색인)이 있는 경로가 주어지면 SpeedReadingInterval은 구간을 정의하고 Speed 카테고리를 사용하여 교통량을 설명합니다.

필드
speed	Speed 출력 전용입니다. 이 간격의 트래픽 속도입니다.
start_polyline_point_index	int32 출력 전용입니다. 경로에서 이 간격의 시작 색인입니다.
end_polyline_point_index	int32 출력 전용입니다. 경로에서 이 간격의 종료 색인입니다.

속도

교통정보 데이터를 기반으로 한 다중선 속도의 분류입니다.

열거형
SPEED_UNSPECIFIED	속도가 지정되지 않았습니다.
NORMAL	정상 속도, 교통 체증 없음
SLOW	속도 저하가 감지되었으며 교통량이 적거나 중간 수준입니다.
TRAFFIC_JAM	정체된 교통을 포함한 교통체증

중지

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

필드
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	클라이언트 오류로 인해 여정이 실패했습니다.
CANCELED	개발자가 명시적으로 이동을 취소했습니다.

TripConfig

여행 구성입니다.

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

TripExecution

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

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