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

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

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

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

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

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

जगह की फ़ोटो (नया)

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

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

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

विशेषताएं

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 (नया) का अनुरोध करने पर, आपको अपने ऐप्लिकेशन में सबसे नया डेटा दिखेगा.

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

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