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

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

परिचय

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

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

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

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

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

Place Photos (नया वर्शन)

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

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

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

टेक्स्ट से खोज (नई) और आस-पास खोज (नई)

Places API में खोज से जुड़े दो एपीआई शामिल हैं:

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

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

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

  • आस-पास की खोज (नया)

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

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

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

अपने-आप पूरा होने वाला टोकन (नया) और सेशन टोकन

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

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

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

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 (New) में, सुलभता से जुड़े विकल्प वाले ये फ़ील्ड शामिल हैं:

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

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

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

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

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

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

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

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

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

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