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

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

परिचय

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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