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,
  "enableRemainingRouteReporting": boolean
}
फ़ील्ड
enableHighFrequencyUpdates

boolean

ज़रूरी नहीं. यात्रा की जानकारी को बार-बार अपडेट करने की सुविधा चालू करनी है या नहीं.

ध्यान दें: इस सुविधा को चालू करने पर, यात्रा को Enterprise Tier के इस्तेमाल में लॉग किया जाता है. साथ ही, इस पर Enterprise Tier के शुल्क लागू होते हैं.
enablePubsub

boolean

ज़रूरी नहीं. यात्रा के लिए pubsub सूचनाएं चालू करनी हैं या नहीं.
pubsubFieldMask

string (FieldMask format)

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

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

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

  • androidAppId
  • iosAppId
  • authToken
  • config

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

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

boolean

ज़रूरी नहीं. यात्रा के लिए, बचे हुए रास्ते की रिपोर्टिंग चालू करनी है या नहीं.

ध्यान दें: इस सुविधा को चालू करने पर, यात्रा को Enterprise Tier के इस्तेमाल में लॉग किया जाता है. साथ ही, इस पर Enterprise Tier के शुल्क लागू होते हैं.

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 क्लाइंट की गड़बड़ी की वजह से यात्रा पूरी नहीं हो सकी.
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)

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

यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में '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)

ज़रूरी है. स्टॉप की जगह की जानकारी, अक्षांश/देशांतर के तौर पर.

रास्ता

रास्ते की पॉलीलाइन.

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)

सिर्फ़ आउटपुट के लिए. रास्ते को अक्षांश/देशांतर की सामान्य सूची के तौर पर दिखाया जाता है.
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 (शून्य पर आधारित इंडेक्स) पॉइंट वाले पाथ के लिए, SpeedReadingInterval एक इंटरवल तय करता है. साथ ही, Speed कैटगरी का इस्तेमाल करके, इसके ट्रैफ़िक के बारे में बताता है.

JSON के काेड में दिखाना 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
फ़ील्ड
speed

enum (Speed)

सिर्फ़ आउटपुट के लिए. इस समयावधि में ट्रैफ़िक की स्पीड.
startPolylinePointIndex

integer

सिर्फ़ आउटपुट के लिए. पाथ में इस इंटरवल का शुरुआती इंडेक्स.
endPolylinePointIndex

integer

सिर्फ़ आउटपुट के लिए. पाथ में इस इंटरवल का आखिरी इंडेक्स.

स्पीड

ट्रैफ़िक डेटा के आधार पर, पॉलीलाइन की स्पीड का क्लासिफ़िकेशन.

Enums
SPEED_UNSPECIFIED स्पीड की जानकारी नहीं दी गई है.
NORMAL सामान्य रफ़्तार, ट्रैफ़िक की वजह से देर नहीं होगी.
SLOW ट्रैफ़िक धीमा है. ट्रैफ़िक न कम है, न ज़्यादा.
TRAFFIC_JAM ट्रैफ़िक की वजह से होने वाली देरी, जिसमें ट्रैफ़िक का रुक जाना भी शामिल है.

तरीके

create

 यह कुकी, यात्रा की जानकारी सेव करती है.

get

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