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

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

परिचय

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

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

जगह के बारे में ज़्यादा जानकारी (नया वर्शन)

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

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

जगह की फ़ोटो (नया वर्शन)

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

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

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

Text Search (नया वर्शन) और Nearby Search (नया वर्शन)

Places API में, खोज के दो एपीआई शामिल हैं:

  • Text Search (नया वर्शन)

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

    कीमत के लेवल, फ़िलहाल खुले होने की स्थिति, रेटिंग या जगह के खास टाइप जैसी जानकारी देकर, खोज को बेहतर बनाया जा सकता है. इसके अलावा, खोज के नतीजों को किसी खास जगह के हिसाब से दिखाने या खोज को किसी खास जगह तक सीमित करने के लिए भी तय किया जा सकता है.

  • Nearby Search (नया वर्शन)

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

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

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

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

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

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

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

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

फ़ील्ड

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

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

विशेषताएं

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

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

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

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

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

एआई की मदद से मिलने वाली खास जानकारी

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

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

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

एआई की मदद से मिलने वाली खास जानकारी, Place Details (नया वर्शन), Text Search (नया वर्शन), और Nearby Search (नया वर्शन) के साथ काम करती हैं. Places API (नया वर्शन) के जवाबों में, एआई की मदद से मिलने वाली ये खास जानकारी उपलब्ध हैं:

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

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

Places API के नए वर्शन पर माइग्रेट करना

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