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

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

परिचय

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

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

Place Details (New)

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

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

Place Photos (नया)

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

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

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

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

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

  • टेक्स्ट से खोजें (नया)

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

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

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

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

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

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

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

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

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

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

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 (नया) में एआई की मदद से काम करने वाली सुविधाएं जोड़ी गई हैं

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

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

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

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

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