Places API के बारे में जानकारी (नए)

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

Places API (नया वर्शन) में ये एपीआई शामिल हैं:

इस दस्तावेज़ में, इन नए एपीआई के बारे में खास जानकारी दी गई है.

जगह की जानकारी (नई)

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

जगह का आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:

Place Photos (नया)

Place Photos (नया) की मदद से, अपने ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ा जा सकता है. इसके लिए, आपको Google Places डेटाबेस में सेव की गई लाखों फ़ोटो का ऐक्सेस दिया जाता है. Place Photos (New) API का इस्तेमाल करके, फ़ोटो ऐक्सेस की जा सकती हैं. साथ ही, इमेज का साइज़ बदलकर अपने ऐप्लिकेशन के लिए सबसे सही साइज़ सेट किया जा सकता है.

Place Photos (New) API के सभी अनुरोधों में फ़ोटो रिसॉर्स का नाम शामिल होना चाहिए. इससे, वापस लाई जाने वाली फ़ोटो की यूनीक पहचान होती है. फ़ोटो के संसाधन का नाम पाने के लिए, इनका इस्तेमाल किया जा सकता है:

Place Details (नया), टेक्स्ट से खोजें (नया) या आस-पास की जगहों की जानकारी (नया) के अनुरोध के जवाब में फ़ोटो के संसाधन का नाम शामिल करने के लिए, पक्का करें कि आपने अनुरोध के फ़ील्ड मास्क में photos फ़ील्ड शामिल किया हो.

टेक्स्ट से खोजें (नई सुविधा) और आस-पास की जगहों की जानकारी (नई सुविधा)

Places API (नया प्रॉडक्ट) में खोज के लिए दो एपीआई शामिल हैं:

  • टेक्स्ट से खोजें (नई सुविधा)

    इसकी मदद से, टेक्स्ट स्ट्रिंग तय की जा सकती है. इस स्ट्रिंग के आधार पर, किसी जगह को खोजा जाता है. उदाहरण के लिए: "ऑस्ट्रेलिया के सिडनी में मिलने वाला मसालेदार शाकाहारी खाना" या "कैलिफ़ोर्निया के पालो ऑल्टो के आस-पास मिलने वाला बेहतरीन सीफ़ूड".

    कीमत, कारोबार के खुले होने की मौजूदा स्थिति, रेटिंग या किसी खास तरह की जगह की जानकारी देकर, खोज के नतीजों को बेहतर बनाया जा सकता है. आपके पास नतीजों को किसी खास जगह के हिसाब से दिखाने या खोज को किसी खास जगह तक सीमित करने का विकल्प भी होता है.

  • आस-पास की जगहों की जानकारी (नया)

    इसकी मदद से, किसी जगह के टाइप की सूची के साथ-साथ खोज के लिए कोई इलाका तय किया जा सकता है. क्षेत्र को एक वृत्त के तौर पर तय करें. इसके लिए, केंद्र बिंदु के अक्षांश और देशांतर के निर्देशांक और त्रिज्या को मीटर में तय करें.

    जगह के टाइप के बारे में बताने वाले एक या उससे ज़्यादा टाइप तय करें. उदाहरण के लिए, किसी इलाके में मौजूद शॉपिंग मॉल में पिज़्ज़ा रेस्टोरेंट ढूंढने के लिए, "pizza_restaurant" और "shopping_mall" डालें.

दोनों तरह की खोजों के बीच मुख्य अंतर यह है कि टेक्स्ट से खोजें (नया वर्शन) में, खोज के लिए कोई भी स्ट्रिंग तय की जा सकती है. वहीं, आस-पास की जगहों की जानकारी (नया वर्शन) में, खोज के लिए कोई खास इलाका तय करना ज़रूरी होता है.

ऑटोकंप्लीट (नया) और सेशन टोकन

ऑटोकंप्लीट (नया) एक वेब सेवा है. यह एचटीटीपी अनुरोध के जवाब में, जगह के सुझाव और क्वेरी के सुझाव देती है. अनुरोध में, टेक्स्ट खोजने के लिए स्ट्रिंग और भौगोलिक सीमाएं तय करें. इससे खोज के दायरे को कंट्रोल किया जा सकेगा.

सेशन टोकन, उपयोगकर्ता की ओर से जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नया) कॉल को सेशन के तौर पर ट्रैक करती हैं. ऑटोकंप्लीट (नया) सुविधा, सेशन टोकन का इस्तेमाल करती है. इससे, उपयोगकर्ता की ऑटोकंप्लीट खोज के क्वेरी और चुनने के चरणों को बिलिंग के लिए अलग सेशन में ग्रुप किया जाता है.

नए फ़ील्ड, एट्रिब्यूट, और सुलभता विकल्प

Places API (नया) में नए फ़ील्ड, एट्रिब्यूट, और ऐक्सेसिबिलिटी के विकल्प शामिल हैं. इससे लोगों को किसी जगह के बारे में ज़्यादा जानकारी मिलती है. इन पहलुओं के बारे में, यहां दिए गए सेक्शन में बताया गया है.

फ़ील्ड

Places API (नया वर्शन) में कई नए फ़ील्ड शामिल हैं:

फ़ील्ड ब्यौरा
regularSecondaryOpeningHours इससे कुछ कार्रवाइयों के लिए खास समय के बारे में पता चलता है. कारोबार के खुले होने का दूसरा समय, मुख्य समय से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट ड्राइव-थ्रू (कार से उतरे बिना ऑर्डर देना) या डिलीवरी के समय को, अपने दूसरे समय के तौर पर सेट कर सकता है.
paymentOptions जगह पर पेमेंट के लिए स्वीकार किए जाने वाले विकल्प. कोई जगह, पेमेंट के एक से ज़्यादा तरीके स्वीकार कर सकती है. अगर पेमेंट के विकल्प की जानकारी उपलब्ध नहीं है, तो पेमेंट के विकल्प वाला फ़ील्ड सेट नहीं होगा. आपके पास ये विकल्प उपलब्ध होंगे:
  • क्रेडिट कार्ड
  • डेबिट कार्ड
  • सिर्फ़ नकद में पैसे चुकाए जा सकते हैं
  • एनएफ़सी पेमेंट
parkingOptions जगह के हिसाब से पार्किंग के विकल्प. आपके पास ये विकल्प उपलब्ध होंगे:
  • मुफ़्त पार्किंग स्थल
  • पार्किंग की सुविधा के लिए पैसे चुकाने होंगे
  • सड़क के किनारे मुफ़्त पार्किंग की सुविधा है
  • वैले पार्किंग की सुविधा
  • गराज में मुफ़्त पार्किंग की सुविधा है
  • गराज में पार्किंग के लिए पेमेंट करना होगा
subDestinations किसी जगह से जुड़ी यूनीक जगहें. उदाहरण के लिए, हवाई अड्डे के टर्मिनल को हवाई अड्डे के उप-गंतव्य माना जाता है.
fuelOptions किसी पेट्रोल पंप पर उपलब्ध ईंधन के विकल्पों के बारे में सबसे नई जानकारी. यह जानकारी समय-समय पर अपडेट की जाती है. इनमें ये विकल्प शामिल हैं:
  • डीज़ल
  • रेगुलर अनलेडेड
  • मिडग्रेड
  • प्रीमियम
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • एलपीजी
  • E80
  • E85
  • मीथेन
  • बायोडीज़ल
  • ट्रक डीज़ल
evChargeOptions इस स्टेशन पर मौजूद इलेक्ट्रिक वाहन (ईवी) चार्जर की संख्या. कुछ ईवी चार्जर में एक से ज़्यादा कनेक्टर होते हैं. हालांकि, हर चार्जर से एक बार में सिर्फ़ एक वाहन को चार्ज किया जा सकता है. इसलिए, इस फ़ील्ड में यह जानकारी दिखती है कि किसी समय पर कितने ईवी चार्जर उपलब्ध हैं.
shortFormattedAddress किसी जगह का छोटा पता, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
primaryType दिए गए नतीजे का मुख्य टाइप. उदाहरण के लिए, किसी जगह को cafe या airport के तौर पर क्लासिफ़ाई किया जा सकता है. किसी जगह के लिए, सिर्फ़ एक मुख्य टाइप हो सकता है. संभावित वैल्यू की पूरी सूची देखने के लिए, इस्तेमाल किए जा सकने वाले टाइप देखें.
primaryTypeDisplayName मुख्य टाइप का डिसप्ले नेम. अगर लागू हो, तो इसे अनुरोध की भाषा के हिसाब से बनाया जाता है. संभावित वैल्यू की पूरी सूची देखने के लिए, इस्तेमाल किए जा सकने वाले टाइप देखें.
entrances डेस्टिनेशन के लिए एंट्री पॉइंट. प्रवेश द्वार, अक्षांश/देशांतर के निर्देशांक का एक ऐसा जोड़ा होता है जो किसी जगह के एंट्री और एक्ज़िट पॉइंट की जगह की जानकारी देता है.
navigationPoints मंज़िल के लिए नेविगेशन पॉइंट. नेविगेशन पॉइंट, सड़क के किनारे मौजूद ऐसी जगह होती है जहां नेविगेशन खत्म हो सकता है. इसमें यात्रा के तरीके और इस्तेमाल की जा सकने वाली सुविधाएं शामिल होती हैं.

विशेषताएं

Places API (नया प्रॉडक्ट) में कई नए एट्रिब्यूट शामिल हैं:

एट्रिब्यूट ब्यौरा
outdoorSeating यहां बाहर बैठकर खाने की सुविधा है.
liveMusic जगह पर लाइव म्यूज़िक की सुविधा है.
menuForChildren जगह पर बच्चों के लिए मेन्यू उपलब्ध है.
servesCocktails जगह पर कॉकटेल मिलती हैं.
servesDessert जगह पर मीठे पकवान मिलते हैं.
servesCoffee जगह पर कॉफ़ी मिलती है.
goodForChildren यह जगह बच्चों के लिए अच्छी है.
allowsDogs जगह पर कुत्तों को लाने की अनुमति है.
restroom जगह पर शौचालय है.
goodForGroups जगह पर ग्रुप के हिसाब से सुविधाएं उपलब्ध हैं.
goodForWatchingSports यह जगह खेल देखने के लिए अच्छी है.

सुलभता से जुड़े विकल्प

Places API (नया वर्शन) में, सुलभता से जुड़े विकल्प वाले ये फ़ील्ड शामिल हैं:

फ़ील्ड ब्यौरा
wheelchairAccessibleParking जगह पर व्हीलचेयर ले जाने की सुविधा वाली पार्किंग है.
wheelchairAccessibleEntrance जगह में व्हीलचेयर ले जाने की सुविधा है.
wheelchairAccessibleRestroom जगह पर व्हीलचेयर ले जाने की सुविधा वाला शौचालय है.
wheelchairAccessibleSeating जगह पर व्हीलचेयर ले जाने की सुविधा है.

एआई की मदद से जनरेट की गई खास जानकारी

Places API (नया) में एआई की मदद से तैयार की गई खास जानकारी, Gemini मॉडल की सुविधाओं का इस्तेमाल करती है. इससे जगहों और इलाकों के बारे में खास जानकारी मिलती है. इससे लोगों को यह तय करने में मदद मिलती है कि उन्हें कहां जाना चाहिए.

एआई की मदद से तैयार की गई खास जानकारी में, अलग-अलग तरह के इनपुट से डेटा इकट्ठा किया जाता है. इससे लोगों को किसी जगह के बारे में ज़्यादा सोच-समझकर फ़ैसले लेने में मदद मिलती है. उदाहरण के लिए, अगर आपको किसी नए रेस्टोरेंट में खाना खाना है, तो एआई की मदद से तैयार की गई खास जानकारी में, मेन्यू की मुख्य बातें दिख सकती हैं. इससे आपको रेस्टोरेंट के माहौल के बारे में पता चल सकता है. साथ ही, उपयोगकर्ताओं की समीक्षाओं से थीम भी मिल सकती हैं. किसी नई जगह पर जाने पर, एआई की मदद से तैयार की गई खास जानकारी से, आस-पास की लोकप्रिय जगहों और सुविधाओं के बारे में जानकारी मिल सकती है.

Places API (नया प्रॉडक्ट) में एआई की मदद से काम करने वाली सुविधाएं जोड़ी गईं

एआई की मदद से तैयार की गई खास जानकारी की सुविधा, जगह के बारे में ज़्यादा जानकारी (नया), टेक्स्ट से खोजें (नया), और आस-पास की जगहों की जानकारी (नया) के साथ काम करती है. एआई की मदद से तैयार की गई खास जानकारी, Places API (नया) के रिस्पॉन्स में उपलब्ध है:

  • जगह की खास जानकारी. इसमें किसी जगह के बारे में कम शब्दों में खास जानकारी दी जाती है.
  • समीक्षा की खास जानकारी, जिसमें समीक्षा करने वालों ने किसी जगह के बारे में जो भी कहा है उसकी खास जानकारी दी जाती है.
  • इलाके की खास जानकारी. इससे आपको आस-पास के इलाके में मौजूद लोकप्रिय जगहों के बारे में खास जानकारी मिलती है. इनमें आस-पास के इलाके के बारे में खास जानकारी और ईवी चार्जिंग स्टेशन के बारे में खास जानकारी शामिल है.

Google इन खास जानकारी को बार-बार फिर से जनरेट करता है, ताकि यह पक्का किया जा सके कि ये खास जानकारी, उपलब्ध नई जानकारी के आधार पर अपडेट की गई हैं. Places API (New) का अनुरोध करने पर, आपको अपने ऐप्लिकेशन में सबसे नया डेटा दिखेगा.

Places API (नया प्रॉडक्ट) पर माइग्रेट करना

अगर आप Places API (लेगसी) के मौजूदा ग्राहक हैं और आपको अपने ऐप्लिकेशन को Places API (नया) का इस्तेमाल करने के लिए माइग्रेट करना है, तो माइग्रेशन से जुड़ा यह दस्तावेज़ देखें: