Package google.maps.navconnect.v1

इंडेक्स

• NavConnectService (इंटरफ़ेस)
• AuthToken (मैसेज)
• CreateTripRequest (मैसेज)
• GetTripRequest (मैसेज)
• Location (मैसेज)
• Stop (मैसेज)
• Trip (मैसेज)
• Trip.State (enum)
• TripConfig (मैसेज)
• TripExecution (मैसेज)

NavConnectService

NavConnect क्लाइंट के लिए, यात्राएं बनाने और पाने की सेवा.

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) यह कुकी, यात्रा की जानकारी सेव करती है. मोबाइल ऐप्लिकेशन से यात्रा शुरू करने से पहले, इस फ़ंक्शन को कॉल करना ज़रूरी है. लौटाई गई ट्रिप में auth_token फ़ील्ड सेट होगा. अनुमति पाने के लिंक नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: https://www.googleapis.com/auth/cloud-platform

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) किसी यात्रा की जानकारी मिलती है. अनुमति पाने के लिंक नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है: https://www.googleapis.com/auth/cloud-platform

AuthToken

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

फ़ील्ड
token	string सिर्फ़ आउटपुट के लिए. पुष्टि करने वाला टोकन, जिसे मोबाइल ऐप्लिकेशन को पास किया जाना चाहिए.
expire_time	Timestamp सिर्फ़ आउटपुट के लिए. वह समय जब पुष्टि करने वाले टोकन की समयसीमा खत्म हो जाएगी.

CreateTripRequest

NavConnectService.CreateTrip के लिए अनुरोध मैसेज.

फ़ील्ड
parent	string ज़रूरी है. वह पैरंट संसाधन जिसके तहत यह यात्रा बनाई जाएगी. फ़ॉर्मैट: projects/{project_number}
trip_id	string ज़रूरी है. यात्रा के लिए इस्तेमाल किया जाने वाला आईडी. यह यात्रा के संसाधन के नाम का आखिरी कॉम्पोनेंट बन जाएगा. यह वैल्यू, RFC-4122 के मुताबिक मान्य यूयूआईडी होनी चाहिए.
trip	Trip ज़रूरी है. वह यात्रा जिसे बनाना है.

GetTripRequest

NavConnectService.GetTrip के लिए अनुरोध मैसेज.

फ़ील्ड
name	string ज़रूरी है. जिस यात्रा की जानकारी चाहिए उसका संसाधन नाम. फ़ॉर्मैट: projects/{project}/trips/{trip_id}

जगह

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

फ़ील्ड
point	LatLng सिर्फ़ आउटपुट के लिए. जगह का अक्षांश/देशांतर.
source_time	Timestamp सिर्फ़ आउटपुट के लिए. वह समय जब क्लाइंट ने जगह की जानकारी दी थी.
server_time	Timestamp सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को जगह की जानकारी का यह अपडेट मिला था.

रोकें

यात्रा के दौरान कोई स्टॉप, जहां कोई टास्क पूरा करना है.

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

भ्रमण

यात्रा.

फ़ील्ड
name	string सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. यात्रा के संसाधन का नाम. फ़ॉर्मैट: projects/{project_number}/trips/{trip_id}.
config	TripConfig इम्यूटेबल. यात्रा के लिए कॉन्फ़िगरेशन.
android_app_id	string सिर्फ़ इनपुट के लिए. इम्यूटेबल. उस मोबाइल ऐप्लिकेशन का Android ऐप्लिकेशन आईडी जो यात्रा की जानकारी का इस्तेमाल करेगा. android_app_id या ios_app_id में से कम से कम एक को सेट करना ज़रूरी है.
ios_app_id	string सिर्फ़ इनपुट के लिए. इम्यूटेबल. उस मोबाइल ऐप्लिकेशन का iOS बंडल आईडी जो यात्रा की जानकारी का इस्तेमाल करेगा. android_app_id या ios_app_id में से कम से कम एक को सेट करना ज़रूरी है.
auth_token	AuthToken सिर्फ़ आउटपुट के लिए. यह एक ओपेक टोकन होता है. यह Google Maps या Waze में NavConnect की यात्रा शुरू करने का ऐक्सेस देता है. साथ ही, इन ऐप्लिकेशन को यात्रा अपडेट करने का ऐक्सेस भी देता है. सिर्फ़ CreateTrip ने वापस लौटाया.
state	State सिर्फ़ आउटपुट के लिए. यात्रा की स्थिति.
execution	TripExecution सिर्फ़ आउटपुट के लिए. यात्रा के पूरा होने से जुड़ा नया डेटा. अगर यात्रा में कोई गड़बड़ी है, तो हो सकता है कि यह सेट न हो.
create_time	Timestamp सिर्फ़ आउटपुट के लिए. सर्वर के हिसाब से वह समय जब यात्रा बनाई गई थी.
update_time	Timestamp सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को यात्रा का नया अपडेट मिला था.

राज्य

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

Enums
STATE_UNSPECIFIED	यात्रा की स्थिति के बारे में जानकारी नहीं दी गई है.
NEW	यात्रा बना दी गई है, लेकिन अभी शुरू नहीं हुई है.
ENROUTE	ट्रांसपोर्टर, मंज़िल के रास्ते में है.
ARRIVED	ट्रांसपोर्टर, मंज़िल पर पहुंच गया है.
SUSPENDED	यात्रा को निलंबित कर दिया गया है.
FAILED	यात्रा पूरी नहीं हो सकी.
CLIENT_ERROR	क्लाइंट की गड़बड़ी की वजह से यात्रा पूरी नहीं हो सकी.

TripConfig

यात्रा के लिए कॉन्फ़िगरेशन.

फ़ील्ड
enable_high_frequency_updates	bool ज़रूरी नहीं. यात्रा से जुड़े अपडेट ज़्यादा फ़्रीक्वेंसी पर पाने की सुविधा चालू करनी है या नहीं. ध्यान दें: इस सुविधा को चालू करने पर, यात्रा को Enterprise टियर के इस्तेमाल में लॉग किया जाता है. साथ ही, इस पर Enterprise टियर के शुल्क लागू होते हैं.
enable_pubsub	bool ज़रूरी नहीं. यात्रा के लिए pubsub सूचनाएं चालू करनी हैं या नहीं.
pubsub_field_mask	FieldMask ज़रूरी नहीं. अगर यह फ़ील्ड सेट किया जाता है, तो pubsub सूचनाओं में सिर्फ़ यात्रा के फ़ील्ड का तय किया गया सबसेट शामिल किया जाएगा. अगर यह नीति सेट नहीं की जाती है, तो PubSub सूचनाओं में यात्रा के सभी फ़ील्ड शामिल किए जाएंगे (डिफ़ॉल्ट व्यवहार). ये फ़ील्ड काम नहीं करते: android_app_id ios_app_id auth_token config ध्यान दें: अगर enable_pubsub की वैल्यू 'गलत' पर सेट है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.

TripExecution

यात्रा पूरी होने के बारे में डेटा.

फ़ील्ड
origin	Location सिर्फ़ आउटपुट के लिए. यात्रा की शुरुआत की जगह. आम तौर पर, यह NavConnect की यात्रा शुरू होने के समय, ट्रांसपोर्टर की जगह होती है.
destination	Stop सिर्फ़ आउटपुट के लिए. मोबाइल ऐप्लिकेशन से रिपोर्ट की गई यात्रा की मंज़िल.
location	Location सिर्फ़ आउटपुट के लिए. यह लोकेशन सिग्नल, ट्रांसपोर्टर की आखिरी लोकेशन दिखाता है. अगर सड़क की जानकारी उपलब्ध है, तो यह सड़क की जानकारी के साथ जगह की जानकारी होगी.
traveled_duration	Duration सिर्फ़ आउटपुट के लिए. अब तक की गई यात्रा का समय.
remaining_duration	Duration सिर्फ़ आउटपुट के लिए. Google के अनुमान के मुताबिक, इस यात्रा में बचा हुआ समय.
traveled_distance_meters	int32 सिर्फ़ आउटपुट के लिए. यात्रा शुरू करने की जगह से तय की गई दूरी, मीटर में.
remaining_distance_meters	int32 सिर्फ़ आउटपुट के लिए. मंज़िल तक पहुंचने के लिए बची हुई दूरी, मीटर में.
stop_added_in_route	bool सिर्फ़ आउटपुट के लिए. यह बताता है कि रास्ते में कोई स्टॉप जोड़ा गया था या नहीं.