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

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

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

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

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

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

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

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

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

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

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