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,
  "enableRemainingRouteReporting": boolean
}
필드
enableHighFrequencyUpdates

boolean

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

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

boolean

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

string (FieldMask format)

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

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

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

  • androidAppId
  • iosAppId
  • authToken
  • config

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

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

boolean

선택사항입니다. 여행의 나머지 경로 보고를 사용 설정할지 여부입니다.

참고: 이 기능을 사용 설정하면 Enterprise 등급 사용량으로 기록되며 Enterprise 등급 요금이 적용됩니다.

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

TripExecution

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

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

object (Location)

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

object (Stop)

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

object (Location)

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

object (Route)

출력 전용입니다. 경로의 나머지 부분에 대한 다중선을 제공합니다.
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)

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

경로

경로 폴리라인입니다.

JSON 표현 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
필드
trafficInformation[]

object (SpeedReadingInterval)

출력 전용입니다. 속도 읽기 간격으로 설명된 다중선의 교통 정보입니다.

참고:

  • 간격이 겹치지 않습니다.
  • 간격이 연속됩니다.
  • 간격은 전체 폴리라인을 포함합니다.
  • 인덱스가 증가하는 순서로 간격이 정렬됩니다.
  • 속도는 각 인터벌에 대해 지정됩니다.

통합 필드 format. 경로 형식입니다.

채워지는 형식은 route_polyline_format 매개변수로 제어됩니다. 설정하지 않으면 기본값은 간단한 다중선입니다. format은 다음 중 하나여야 합니다.
simplePolyline

object (SimplePolyline)

출력 전용입니다. 경로를 간단한 latlng 목록으로 나타냅니다.
encodedPolyline

string

출력 전용입니다. 인코딩된 다중선으로 표시된 경로입니다. https://developers.google.com/maps/documentation/utilities/polylinealgorithm을 참고하세요.
s2Polyline

string (bytes format)

출력 전용입니다. 인코딩된 S2Polyline으로 표시된 경로입니다. https://s2geometry.io/devguide/basic_types.html을 참고하세요.

base64 인코딩 문자열입니다.
geoJson

object (Struct format)

출력 전용입니다. GeoJSON LineString으로 표시된 경로입니다. https://tools.ietf.org/html/rfc7946#section-3.1.4를 참고하세요.

SimplePolyline

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

JSON 표현 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
필드
points[]

object (LatLng)

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

SpeedReadingInterval

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

JSON 표현 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
필드
speed

enum (Speed)

출력 전용입니다. 이 간격의 트래픽 속도입니다.
startPolylinePointIndex

integer

출력 전용입니다. 경로에서 이 간격의 시작 색인입니다.
endPolylinePointIndex

integer

출력 전용입니다. 경로에서 이 간격의 종료 색인입니다.

속도

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

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

메서드

create

 여행을 만듭니다.

get

 여행을 가져옵니다.