REST Resource: projects.trips

리소스: Trip

여행

JSON 표현 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
필드
name

string

출력 전용입니다. 식별자. 여행의 리소스 이름입니다. 형식: projects/{project_number}/trips/{tripId}
config

object (TripConfig)

변경할 수 없습니다. 여행의 구성입니다.
androidAppId

string

입력 전용입니다. 변경할 수 없습니다. 여행을 사용할 모바일 애플리케이션의 Android 애플리케이션 ID입니다. androidAppId 또는 iosAppId 중 하나 이상을 설정해야 합니다.
iosAppId

string

입력 전용입니다. 변경할 수 없습니다. 이 여정을 사용할 모바일 애플리케이션의 iOS 번들 ID입니다. androidAppId 또는 iosAppId 중 하나 이상을 설정해야 합니다.
authToken

object (AuthToken)

출력 전용입니다. Google 지도 또는 Waze에서 NavConnect 이동을 시작할 수 있는 액세스 권한을 부여하고 이러한 애플리케이션에 이동을 업데이트할 수 있는 액세스 권한을 부여하는 불투명 토큰입니다. trips.create에서만 반환됩니다.
state

enum (State)

출력 전용입니다. 여행 상태입니다.
execution

object (TripExecution)

출력 전용입니다. 이동 실행에 관한 최신 데이터입니다. 여행이 오류 상태인 경우 설정되지 않을 수 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. 여행이 생성된 서버 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 서버가 최신 이동 업데이트를 수신한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

TripConfig

여행 구성입니다.

JSON 표현 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string
}
필드
enableHighFrequencyUpdates

boolean

선택사항입니다. 고빈도 이동 업데이트를 사용 설정할지 여부입니다.

참고: 이 기능을 사용 설정하면 Enterprise 등급 사용량에 따라 이동이 기록되며 Enterprise 등급 요금이 적용됩니다.
enablePubsub

boolean

선택사항입니다. 여행에 Pubsub 알림을 사용 설정할지 여부입니다.
pubsubFieldMask

string (FieldMask format)

선택사항입니다. 설정된 경우 지정된 이동 필드의 하위 집합만 Pub/Sub 알림에 포함됩니다.

설정하지 않으면 모든 여행 필드가 Pub/Sub 알림에 포함됩니다 (기본 동작).

다음 필드는 지원되지 않습니다.

  • androidAppId
  • iosAppId
  • authToken
  • config

참고: enablePubsub이 false이면 이 필드는 무시됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

AuthToken

인증 토큰입니다.

JSON 표현 
{
  "token": string,
  "expireTime": string
}
필드
token

string

출력 전용입니다. 모바일 애플리케이션에 전달되어야 하는 인증 토큰입니다.
expireTime

string (Timestamp format)

출력 전용입니다. 인증 토큰이 만료되는 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

주

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

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

TripExecution

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

JSON 표현 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
필드
origin

object (Location)

출력 전용입니다. 이동의 출발지입니다. 일반적으로 NavConnect 이동 시작 시 운송업체의 위치입니다.
destination

object (Stop)

출력 전용입니다. 모바일 애플리케이션에서 보고한 여행의 목적지입니다.
location

object (Location)

출력 전용입니다. 운송업체의 마지막으로 알려진 위치를 나타내는 위치 신호입니다. 사용 가능한 경우 스냅된 도로 위치입니다.
traveledDuration

string (Duration format)

출력 전용입니다. 지금까지 이동한 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
remainingDuration

string (Duration format)

출력 전용입니다. Google에서 추정한 이 여정의 남은 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
traveledDistanceMeters

integer

출력 전용입니다. 원점에서 이동한 거리(미터)입니다.
remainingDistanceMeters

integer

출력 전용입니다. 목적지까지 남은 거리(미터)입니다.
stopAddedInRoute

boolean

출력 전용입니다. 경로에 경유지가 추가되었는지 여부를 나타냅니다.

위치

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

JSON 표현 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
필드
point

object (LatLng)

출력 전용입니다. 위치 위도/경도입니다.
sourceTime

string (Timestamp format)

출력 전용입니다. 클라이언트가 표시한 위치가 제공된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
serverTime

string (Timestamp format)

출력 전용입니다. 서버가 이 위치 업데이트를 수신한 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

LatLng

위도/경도 쌍을 나타내는 객체로 위도와 경도를 나타내는 복식 쌍으로 표현됩니다. 달리 명시되지 않는 한 이 객체는 WGS84 표준을 준수해야 합니다. 값은 정규화된 범위 내에 있어야 합니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

위도입니다. 범위는 [-90.0, +90.0]입니다.
longitude

number

경도입니다. 범위는 [-180.0, +180.0]입니다.

중지

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

JSON 표현 
{
  "point": {
    object (LatLng)
  }
}
필드
point

object (LatLng)

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

메서드

create

 여행을 만듭니다.

get

 여행을 가져옵니다.