REST Resource: projects.trips

संसाधन: यात्रा

यात्रा.

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 ऐप्लिकेशन आईडी जो यात्रा की जानकारी का इस्तेमाल करेगा. androidAppId या iosAppId में से कम से कम एक को सेट करना ज़रूरी है.
iosAppId

string

सिर्फ़ इनपुट के लिए. इम्यूटेबल. उस मोबाइल ऐप्लिकेशन का iOS बंडल आईडी जो यात्रा की जानकारी का इस्तेमाल करेगा. androidAppId या iosAppId में से कम से कम एक को सेट करना ज़रूरी है.
authToken

object (AuthToken)

सिर्फ़ आउटपुट के लिए. यह एक ओपेक टोकन होता है. यह Google Maps या Waze में NavConnect की यात्रा शुरू करने का ऐक्सेस देता है. साथ ही, इन ऐप्लिकेशन को यात्रा अपडेट करने का ऐक्सेस भी देता है. सिर्फ़ trips.create ने वापस लौटाया.
state

enum (State)

सिर्फ़ आउटपुट के लिए. यात्रा की स्थिति.
execution

object (TripExecution)

सिर्फ़ आउटपुट के लिए. यात्रा के पूरा होने से जुड़ा नया डेटा. अगर यात्रा में कोई गड़बड़ी है, तो हो सकता है कि यह सेट न हो.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. सर्वर के हिसाब से वह समय जब यात्रा बनाई गई थी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को यात्रा का नया अपडेट मिला था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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)

ज़रूरी नहीं. अगर यह फ़ील्ड सेट किया जाता है, तो pubsub सूचनाओं में सिर्फ़ यात्रा के फ़ील्ड का तय किया गया सबसेट शामिल किया जाएगा.

अगर यह नीति सेट नहीं की जाती है, तो PubSub सूचनाओं में यात्रा के सभी फ़ील्ड शामिल किए जाएंगे (डिफ़ॉल्ट व्यवहार).

ये फ़ील्ड काम नहीं करते:

  • androidAppId
  • iosAppId
  • authToken
  • config

ध्यान दें: अगर enablePubsub की वैल्यू 'गलत' पर सेट है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की कॉमा से अलग की गई सूची है. उदाहरण: "user.displayName,photo".

AuthToken

पुष्टि करने वाला टोकन.

JSON के काेड में दिखाना 
{
  "token": string,
  "expireTime": string
}
फ़ील्ड
token

string

सिर्फ़ आउटपुट के लिए. पुष्टि करने वाला टोकन, जिसे मोबाइल ऐप्लिकेशन को पास किया जाना चाहिए.
expireTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब पुष्टि करने वाले टोकन की समयसीमा खत्म हो जाएगी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

राज्य

यात्रा की सभी संभावित स्थितियां.

Enums
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)

सिर्फ़ आउटपुट के लिए. अब तक की गई यात्रा का समय.

यह अवधि सेकंड में होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में 's' होता है. उदाहरण: "3.5s".
remainingDuration

string (Duration format)

सिर्फ़ आउटपुट के लिए. Google के अनुमान के मुताबिक, इस यात्रा में बचा हुआ समय.

यह अवधि सेकंड में होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में 's' होता है. उदाहरण: "3.5s".
traveledDistanceMeters

integer

सिर्फ़ आउटपुट के लिए. यात्रा शुरू करने की जगह से तय की गई दूरी, मीटर में.
remainingDistanceMeters

integer

सिर्फ़ आउटपुट के लिए. मंज़िल तक पहुंचने के लिए बची हुई दूरी, मीटर में.
stopAddedInRoute

boolean

सिर्फ़ आउटपुट के लिए. यह बताता है कि रास्ते में कोई स्टॉप जोड़ा गया था या नहीं.

जगह

मोबाइल ऐप्लिकेशन से रिपोर्ट की गई जगह की जानकारी.

JSON के काेड में दिखाना 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
फ़ील्ड
point

object (LatLng)

सिर्फ़ आउटपुट के लिए. जगह का अक्षांश/देशांतर.
sourceTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब क्लाइंट ने जगह की जानकारी दी थी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को जगह की जानकारी का यह अपडेट मिला था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "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

 किसी यात्रा की जानकारी मिलती है.