नेविगेशन ऐप्लिकेशन के इंटेंट लागू करना

Google Assistant, इंटेंट के तीन अलग-अलग फ़ॉर्मैट का इस्तेमाल करती है. ये फ़ॉर्मैट, आपके नेविगेशन ऐप्लिकेशन के साथ काम कर सकते हैं. अपने ऐप्लिकेशन और Google Assistant को इंटिग्रेट करने के लिए, अपने ऐप्लिकेशन के मेनिफ़ेस्ट में इस पेज पर बताए गए इंटेंट फ़िल्टर का एलान करें. इससे, दोनों के बीच इंटरऑपरेबिलिटी भी हासिल की जा सकती है. इंटेंट के बारे में ज़्यादा जानने के लिए, Intent देखें.

Assistant के नेविगेशन ऐप्लिकेशन Intent क्लास में, इन इंटेंट का इस्तेमाल किया जा सकता है:

  • नेविगेशन इंटेंट
  • सर्च इंटेंट
  • कस्टम ऐक्शन इंटेंट

इंटेंट डेटा फ़्लो

पहली इमेज. इंटेंट डेटा फ़्लो.

इंटेंट डेटा में पैरामीटर

इंटेंट डेटा, यूआरआई फ़ॉर्मैट का पालन करता है. इसमें, आपके पास भेजे गए इंटेंट के आधार पर पैरामीटर होते हैं. कुछ पैरामीटर हमेशा डेटा में शामिल होते हैं. इसका मतलब है कि आपके पास यह उम्मीद करने का विकल्प है कि उनमें हमेशा साफ़ तौर पर वैल्यू दी गई हो. हालांकि, वैकल्पिक पैरामीटर के लिए डेटा में हमेशा कोई वैल्यू सेट नहीं होती. ज़्यादा जानकारी के लिए, डेटा टेस्ट देखें.

ऑफ़लाइन इंटेंट

इस पेज पर दिए गए सभी इंटेंट के ऑफ़लाइन वैरिएंट उपलब्ध हैं. इनके बीच अंतर करने के लिए, उनकी स्कीम में .offline जोड़ें. उदाहरण के लिए, नेविगेशन इंटेंट, geo.offline स्कीम का इस्तेमाल करता है. मेनिफ़ेस्ट में मौजूद ये इंटेंट फ़िल्टर, ऐप्लिकेशन के इन ऐक्शन को ऑफ़लाइन इस्तेमाल करने की सुविधा के बारे में बताते हैं.

किसी खास डेस्टिनेशन पर नेविगेट करने के लिए, उपयोगकर्ता के अनुरोध को पूरा करने के लिए नेविगेशन इंटेंट का इस्तेमाल करें. यह डेस्टिनेशन एक जगह (पता) या एक से ज़्यादा जगहें (जैसे, कॉफ़ी शॉप और पेट्रोल पंप) हो सकती हैं. इंटेंट डेटा, हर इंटेंट के लिए तय किए गए यूआरआई फ़ॉर्मैट का पालन करता है.

इंटेंट फ़ॉर्मैट

Intent क्लास, नेविगेशन ऐप्लिकेशन इंटेंट के लिए इस फ़ॉर्मैट का इस्तेमाल करती है:

कैटगरी: android.intent.category.DEFAULT

कार्रवाई:

  • Android Auto और Android Automotive OS: androidx.car.app.action.NAVIGATE
  • डिवाइस के अन्य नाप या आकार: android.intent.action.NAVIGATE

स्कीम: geo

उदाहरण:

  • geo:0,0?q=Googleplex
  • geo:0,0?q=1600+Amphitheatre+parkway&mode=b&intent=add_a_stop
  • geo:0,0?q=coffee+shop&mode=w&intent=navigation
  • geo:1.1,2.2?q=Starbucks+on+Main+Street&mode=w&intent=navigation

ऐप्लिकेशन के काम करने का सुझाया गया तरीका: बताई गई जगह पर नेविगेट करना शुरू हो जाता है या उपयोगकर्ता से कई विकल्पों में से किसी एक को चुनने के लिए कहा जाता है.

मेनिफ़ेस्ट इंटेंट फ़िल्टर

अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में, नीचे दिए गए इंटेंट फ़ॉर्मैट का एलान करें, ताकि Google Assistant को पता चले कि आपके नेविगेशन ऐप्लिकेशन को नेविगेशन इंटेंट मिल सकते हैं.

Android Auto और Android Automotive OS के अलावा, सभी डिवाइसों के साइज़, डाइमेंशन या कॉन्फ़िगरेशन:

<intent-filter>
  <action android:name="android.intent.action.NAVIGATE" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

Android Auto और Android Automotive OS:

<intent-filter>
  <action android:name="androidx.car.app.action.NAVIGATE" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

दिए गए पैरामीटर

दिए गए नेविगेशन ऐप्लिकेशन के इंटेंट डेटा में, नीचे दिए गए पैरामीटर उपलब्ध होने चाहिए.

जगह की क्वेरी या भौगोलिक निर्देशांक

अनुरोध किए गए डेटा के टाइप के आधार पर, हर नेविगेशन इंटेंट क्वेरी में इनमें से एक या दोनों पैरामीटर होते हैं:

  • जगह की जानकारी से जुड़ी क्वेरी

    इससे उस जगह की जानकारी मिलती है जहां उपयोगकर्ता नेविगेट करने की कोशिश कर रहा है. उपयोगकर्ता के डेस्टिनेशन का पता लगाने के लिए, इस डेटा का इस्तेमाल करें.

    पैरामीटर कुंजी: q
    वैल्यू: उपयोगकर्ता का क्वेरी किया गया डेस्टिनेशन.

    उदाहरण: geo:0,0?q=Golden+Gate+Bridge
    व्याख्या: उपयोगकर्ता गोल्डन गेट ब्रिज पर जाना चाहता है.

  • भौगोलिक निर्देशांक (अक्षांश और देशांतर)

    नेविगेशन के लिए उपयोगकर्ता के इस्तेमाल किए गए खास निर्देशों को दिखाता है.

    पैरामीटर कुंजी: geo:lat,long
    वैल्यू: उपयोगकर्ता के क्वेरी किए गए निर्देशांक.

    उदाहरण: geo:1.1,2.2?mode=w&intent=navigation
    इंटरप्रिटेशन: उपयोगकर्ता को निर्देशांक (1.1, 2.2) पर जाना है.

वैकल्पिक पैरामीटर

नेविगेशन ऐप्लिकेशन के इंटेंट डेटा में दिए गए वैकल्पिक पैरामीटर के बारे में इस सेक्शन में बताया गया है.

इंटेंट

उपयोगकर्ता के मकसद के बारे में बताता है. अगर यह पैरामीटर सेट नहीं है, तो उपयोगकर्ता के डिफ़ॉल्ट इंटेंट को navigation माना जाता है.

पैरामीटर कुंजी: intent
संभावित वैल्यू:

  • navigation [डिफ़ॉल्ट वैल्यू] - डेस्टिनेशन की जगह ले लेता है और नेविगेशन शुरू करता है. इसका इस्तेमाल x पर जाएं जैसी क्वेरी के लिए करें.
  • add_a_stop - स्टॉप को पिछली मंज़िलों के साथ अगली मंज़िल के तौर पर जोड़ता है. इसका इस्तेमाल x पर स्टॉप जोड़ें जैसी क्वेरी के लिए करें.
  • directions - नेविगेशन शुरू किए बिना, रास्ते के निर्देश दिखाता है. x के लिए निर्देश जैसी क्वेरी के लिए, इसका इस्तेमाल करें.

उदाहरण: geo:47.61594547836694,-122.20373173098756?q=575+Bellevue+Square,+Bellevue,+WA+98004&intent=add_a_stop इंटरप्रिटेशन: उपयोगकर्ता, Bellevue Square, Bellevue में मौजूद स्टॉप को जोड़ना चाहता है. साथ ही, उस स्टॉप के मौजूदा निर्देशांक [47.6, -122.2] का इस्तेमाल करना चाहता है.

बंद करें

नेविगेशन में किन चीज़ों से बचना चाहिए, इस बारे में बताता है.

पैरामीटर कुंजी: avoid
संभावित वैल्यू:

  • f - फ़ेरी
  • h - हाइवे
  • t - टोल की रकम

उदाहरण: geo:0,0?q=googleplex&avoid=tf
व्याख्या: उपयोगकर्ता, टोल और फ़ेरी से बचते हुए Googleplex पर जाना चाहता है.

यात्रा मोड

यात्रा मोड से, उपयोगकर्ता की क्वेरी में बताए गए, यात्रा के तरीके के बारे में पता चलता है.

पैरामीटर कुंजी: mode
संभावित वैल्यू:

  • b - साइकल
  • d - ड्राइव
  • x - टैक्सी
  • l - दोपहिया वाहन
  • r - ट्रांज़िट
  • w - पैदल चलना

उदाहरण: geo:0,0?q=Googleplex&mode=r
अनुवाद: उपयोगकर्ता, सार्वजनिक परिवहन का इस्तेमाल करके Googleplex पर जाना चाहता है.

एंट्री

इसका इस्तेमाल, एंट्री के सोर्स को लॉग करने के लिए किया जाता है.

इसकी ये वैल्यू हो सकती हैं: assistant

उदाहरण: geo:47.61594547836694,-122.20373173098756?entry=assistant

सर्च इंटेंट

किसी क्वेरी को खोजने के लिए, सर्च इंटेंट का इस्तेमाल करें. साथ ही, ड्राइविंग के दौरान रास्ते के साथ-साथ कई नतीजे दिखाएं.

इंटेंट फ़ॉर्मैट

Intent क्लास, सर्च इंटेंट के लिए इस फ़ॉर्मैट का इस्तेमाल करती है:

कैटगरी: android.intent.category.DEFAULT

कार्रवाई: android.intent.action.VIEW

स्कीम: geo

उदाहरण: geo:0,0?q=restaurants+nearby

ऐप्लिकेशन के सुझाए गए व्यवहार: उपयोगकर्ता की क्वेरी से मेल खाने वाली जगहों की सूची खोलें.

मेनिफ़ेस्ट इंटेंट फ़िल्टर

अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में, इनटेंट के लिए यह फ़ॉर्मैट इस्तेमाल करें, ताकि Google Assistant को पता चल सके कि आपके नेविगेशन ऐप्लिकेशन को खोज के इंटेंट मिल सकते हैं:

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo" />
</intent-filter>

दिए गए पैरामीटर

दिए गए सर्च इंटेंट डेटा में, ये पैरामीटर उपलब्ध होने चाहिए.

जगह की जानकारी से जुड़ी क्वेरी

जगह की क्वेरी वह जगह होती है जिसे ड्राइविंग के दौरान उपयोगकर्ता खोजता है. यह क्वेरी सटीक नहीं हो सकती या किसी चालू नेविगेशन रूट पर हो सकती है.

पैरामीटर कुंजी: q
वैल्यू: उपयोगकर्ता का खोज शब्द, जो किसी जगह का टाइप हो सकता है, जैसे कि कॉफ़ी शॉप या कॉलेज. हालांकि, इसमें संख्या बताने वाले शब्द भी हो सकते हैं, जैसे कि -मेरे आस-पास या -सबसे अच्छी रेटिंग वाली.

उदाहरण: geo:0,0?q=restaurants+nearby
अनुमान: उपयोगकर्ता को आस-पास के रेस्टोरेंट खोजने हैं.

कस्टम ऐक्शन इंटेंट

कस्टम ऐक्शन के लिए कस्टम इंटेंट का इस्तेमाल करें. जैसे, दुर्घटनाओं की शिकायत करना और नेविगेशन को खत्म करना. मुख्य कार्रवाई का टाइप, act क्वेरी पैरामीटर से तय होता है. कार्रवाई के टाइप के आधार पर, अतिरिक्त पैरामीटर सेट किए जा सकते हैं.

इंटेंट फ़ॉर्मैट

Intent क्लास, कस्टम ऐक्शन इंटेंट के लिए इस फ़ॉर्मैट का इस्तेमाल करती है:

कैटगरी: android.intent.category.DEFAULT

कार्रवाई: android.intent.action.VIEW

स्कीम: geo.action

उदाहरण: geo.action:?act=report&accident_type=major

मेनिफ़ेस्ट इंटेंट फ़िल्टर

अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में, नीचे दिया गया इंटेंट फ़ॉर्मैट डालें. इससे Google Assistant को पता चलेगा कि आपके नेविगेशन ऐप्लिकेशन को कस्टम ऐक्शन इंटेंट मिल सकते हैं.

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT"/>
  <data android:scheme="geo.action" />
</intent-filter>

दिए गए पैरामीटर

दिए गए कस्टम ऐक्शन इंटेंट डेटा में ये पैरामीटर उपलब्ध होने चाहिए:

कार्रवाई का टाइप

इससे यह तय होता है कि उपयोगकर्ता किस तरह की कस्टम कार्रवाई करना चाहता है.

पैरामीटर बटन: act

उदाहरण:

  • geo.action:?act=report_crash&accident_type=major
    अनुवाद: उपयोगकर्ता को किसी बड़ी दुर्घटना की शिकायत करनी है.

  • geo.action:?act=mute
    अनुवाद: उपयोगकर्ता, बोलकर दिए जाने वाले निर्देशों को म्यूट करना चाहता है.

  • geo.action:?act=exit_navigation
    अनुमान: उपयोगकर्ता, मौजूदा नेविगेशन से बाहर निकलना चाहता है.

ऐप्लिकेशन के लिए सुझाया गया तरीका: नेविगेशन ऐप्लिकेशन पर, अनुरोध की गई कार्रवाई को पूरा करें या ऐसी कार्रवाई न करने का मैसेज दिखाएं.

इस इमेज में, रिस्पॉन्स क्वेरी में की-वैल्यू पेयर का उदाहरण दिया गया है:

कस्टम ऐक्शन इंटेंट का डेटा फ़्लो

दूसरी इमेज. कस्टम ऐक्शन इंटेंट का डेटा फ़्लो.

की-वैल्यू पेयर: 

"act": "report_crash"
"road_direction": other_side"

हर कस्टम ऐक्शन में, हमेशा act पैरामीटर को कुंजी के तौर पर इस्तेमाल किया जाता है. ऊपर दिए गए उदाहरण वाले कोड में, कुछ कार्रवाइयों में अतिरिक्त की-वैल्यू पेयर हो सकते हैं. उदाहरण के लिए, act=report_crash इन अतिरिक्त बटन के साथ काम करता है: accident_type और road_direction.

कुंजी accident_type में दो वैल्यू, minor और major हो सकती हैं.

संभावित वैल्यू

टेबल में उन संभावित वैल्यू की सूची दी गई है जिन्हें Google Assistant, नेविगेशन ऐप्लिकेशन पर उपयोगकर्ता की कार्रवाई के तौर पर पास कर सकती है.

वैल्यू ब्यौरा वैकल्पिक पैरामीटर कुंजियां वैकल्पिक पैरामीटर वैल्यू
allow_ferries फ़ेरी की अनुमति देने के लिए, रास्ते की प्राथमिकता बदलें.
allow_highways राजमार्गों को शामिल करने के लिए, रास्ते की प्राथमिकता बदलें.
allow_tolls टोल की सुविधा चालू करने के लिए, रास्ते की प्राथमिकता बदलना.
apply_electric_vehicle_connector_filter सिर्फ़ ईवी चार्जिंग की ऐसी जगहें दिखाएं जो कार के कनेक्टर से मेल खाती हों.
apply_electric_vehicle_fast_charging_filter सिर्फ़ फ़ास्ट चार्जर वाली ईवी चार्जिंग की जगहें दिखाएं.
apply_electric_vehicle_payment_filter सिर्फ़ वे ईवी चार्जिंग स्टेशन दिखाएं जिनके लिए पेमेंट करना ज़रूरी है.
avoid_ferries फ़ेरी से यात्रा न करने के लिए, रास्ते की सेटिंग बदलें.
avoid_highways हाइवे से बचने के लिए, रास्ते की सेटिंग बदलें.
avoid_tolls टोल से बचने के लिए, रास्ते की प्राथमिकता बदलें.
clear_search_results मैप पर खोज के नतीजे मिटाएं.
distance_to_destination मंज़िल की दूरी दिखाएं.
distance_to_next_turn अगले मोड़ की दूरी दिखाएं.
eta डेस्टिनेशन तक पहुंचने में लगने वाला अनुमानित समय दिखाएं.
exit_navigation नेविगेशन से बाहर निकलें या उसे रद्द करें.
follow_mode मैप व्यू को फ़ॉलो मोड में बदलें.
go_back मैप पर की गई पिछली कार्रवाई पर वापस जाएं.
hide_satellite सैटलाइट की जानकारी छिपाने के लिए, मैप की सेटिंग बदलें.
hide_traffic ट्रैफ़िक की जानकारी छिपाने के लिए, मैप की सेटिंग बदलें.
mute आवाज़ से रास्ता बताने की सुविधा को म्यूट करें.
query_current_road यह दिखाना कि उपयोगकर्ता किस सड़क पर है.
query_destination दिखाएं कि डेस्टिनेशन क्या है.
query_next_turn अगला मोड़ कौनसा है, यह दिखाएं.
remove_electric_vehicle_connector_filter कार के कनेक्टर से मेल खाने वाली ईवी चार्जिंग लोकेशन के लिए, फ़िल्टर हटाएं.
remove_electric_vehicle_fast_charging_filter फ़ास्ट चार्जर वाली ईवी चार्जिंग की जगहों के लिए फ़िल्टर हटाएं.
remove_electric_vehicle_payment_filter ईवी चार्जिंग की उन जगहों को फ़िल्टर करने की सुविधा हटाएं जहां पैसे चुकाने पड़ते हैं.
report_crash क्रैश की शिकायत करें. accident_type minor
major
road_direction this_side
other_side
report_hazard खतरों की शिकायत करना. hazard_type animal
broken_traffic_light
construction
flooding
fog
hail
ice
missing_sign
object_on_road
pothole
roadkill
snow
vehicle
weather
road_direction this_side
other_side
location_on_road on_road
on_shoulder
report_police पुलिस की गतिविधि की शिकायत करें. road_direction this_side
other_side
report_road_closure बंद सड़कों के बारे में जानकारी दें. road_closure_type partial
full
report_traffic ट्रैफ़िक की शिकायत करें. traffic_type moderate
heavy
standstill
road_direction this_side
other_side
resume_navigation नेविगेशन फिर से शुरू करें.
route_overview रास्ते की खास जानकारी दिखाएं.
show_alternates वैकल्पिक रास्ते दिखाएं.
show_directions_list मोड़-दर-मोड़ निर्देश दिखाएं.
show_satellite मैप पर उपग्रह की मदद से ली गई इमेज की जानकारी दिखाएं.
show_traffic मैप पर ट्रैफ़िक की जानकारी दिखाएं.
time_to_destination डेस्टिनेशन तक पहुंचने में लगने वाला अनुमानित समय दिखाएं.
time_to_next_turn अगले मोड़ तक पहुंचने में लगने वाला अनुमानित समय दिखाएं.
unmute रास्ता बताने वाली आवाज़ को अनम्यूट करें.