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

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

परिचय

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

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

Place Details (New)

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

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

Place Photos (नया)

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

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

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

टेक्स्ट से खोजें (नया) और आस-पास की जगहों की जानकारी (नया)

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

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

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

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

  • Nearby Search (New)

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

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

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

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

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

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

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