Places API (नया वर्शन) में ये एपीआई शामिल हैं:
- जगह की जानकारी (नई)
- जगह की फ़ोटो (नई)
- आस-पास खोजने की सुविधा (नया)
- टेक्स्ट खोज (नई सुविधा)
- ऑटोकंप्लीट की सुविधा (नई सुविधा)
इस दस्तावेज़ में इन नए एपीआई की खास जानकारी शामिल है.
जगह की जानकारी (नई)
जगह का आईडी, Google Places डेटाबेस और Google Maps पर किसी जगह की खास तौर पर पहचान करता है. जगह के आईडी की मदद से, किसी खास संस्थान या लोकप्रिय जगह की जानकारी पाने के लिए, जगह की जानकारी (नई) का अनुरोध किया जा सकता है. जगह की जानकारी (नया) का अनुरोध करने पर, बताई गई जगह की पूरी जानकारी दिखती है. जैसे, जगह का पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट खोज (नई सुविधा)
- आस-पास खोजने की सुविधा (नया)
- जियोकोडिंग एपीआई
- रूट एपीआई
- पते की पुष्टि करने वाला एपीआई
- जगह की जानकारी के अपने-आप पूरे होने की सुविधा
जगह की फ़ोटो (नई)
Place Photo (नया) API, आपको Google स्थल डेटाबेस में संग्रहित लाखों फ़ोटो का ऐक्सेस देकर अपने ऐप्लिकेशन में अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ने देता है. प्लेस फ़ोटो (नया) एपीआई का इस्तेमाल करके, आप फ़ोटो ऐक्सेस कर सकते हैं और अपने ऐप्लिकेशन के लिए इमेज का सबसे सही साइज़ बदल सकते हैं.
जगह की फ़ोटो (नया) एपीआई के सभी अनुरोधों में फ़ोटो रिसॉर्स का नाम शामिल होना चाहिए. इससे फ़ोटो की पहचान करने में मदद मिलती है. फ़ोटो रिसॉर्स का नाम पाने के लिए, इन चीज़ों का इस्तेमाल किया जा सकता है:
किसी जगह की जानकारी (नई), टेक्स्ट सर्च (नया) या आस-पास की खोज (नया) के जवाब में फ़ोटो रिसॉर्स का नाम शामिल करने के लिए, पक्का करें कि आपने अनुरोध के फ़ील्ड मास्क में photos
फ़ील्ड शामिल किया हो.
टेक्स्ट से खोजें (नई) और आस-पास की खोज (नई)
Places API में दो खोज एपीआई होते हैं:
-
इससे आपको एक टेक्स्ट स्ट्रिंग तय करने की सुविधा मिलती है, जिस पर किसी जगह को खोजना है. उदाहरण के लिए: "सिडनी, ऑस्ट्रेलिया में मसालेदार भोजन" या "पालो आल्टो, कनाडा के पास फ़ाइन सी-फ़ूड डाइनिंग".
कीमत के लेवल, खुलने की मौजूदा स्थिति, रेटिंग या खास तरह की जगहों जैसी जानकारी देकर, खोज को बेहतर बनाया जा सकता है. नतीजों को किसी खास जगह के हिसाब से दिखाया जा सकता है या खोज को किसी खास जगह पर सीमित किया जा सकता है.
-
इससे आपको जगहों के टाइप की सूची के साथ खोजने के लिए, किसी इलाके का नाम बताने की सुविधा मिलती है. क्षेत्र को सर्कल के तौर पर बताएं. इसके लिए, सेंटर पॉइंट और रेडियस के अक्षांश और देशांतर निर्देशांकों से मीटर में बदलें.
एक या एक से ज़्यादा ऐसे टाइप के बारे में बताएं जिनसे जगहों की विशेषताओं के बारे में पता चलता है. उदाहरण के लिए, किसी खास इलाके के शॉपिंग मॉल में मौजूद पिज़्ज़ा रेस्टोरेंट खोजने के लिए, "
pizza_restaurant
" और "shopping_mall
" तय करें.
इन दोनों खोजों के बीच मुख्य अंतर यह है कि टेक्स्ट सर्च (नई) की मदद से, आपको आर्बिट्रेरी सर्च स्ट्रिंग के बारे में बताया जा सकता है, जबकि आस-पास सर्च (नया) के लिए एक खास एरिया की ज़रूरत होती है.
ऑटोकंप्लीट (नया) और सेशन टोकन
ऑटोकंप्लीट (नई सुविधा) एक ऐसी वेब सेवा है जो किसी एचटीटीपी अनुरोध के जवाब में, जगह के लिए सुझाव और क्वेरी के अनुमान दिखाती है. अनुरोध में, ऐसी टेक्स्ट सर्च स्ट्रिंग और भौगोलिक सीमाएं डालें जो खोज के लिए इस्तेमाल होने वाले इलाके को कंट्रोल करती हों.
सेशन टोकन, उपयोगकर्ता की जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नए) कॉल को सेशन के तौर पर ट्रैक करती हैं. ऑटोकंप्लीट (नया वर्शन) में, बिलिंग के मकसद से किसी उपयोगकर्ता के ऑटोकंप्लीट खोज नतीजे की क्वेरी और उसे चुनने के चरणों का ग्रुप बनाने के लिए, सेशन टोकन का इस्��ेमाल किया जाता है.
नए फ़ील्ड, एट्रिब्यूट, और सुलभता के विकल्प
Places API (नया वर्शन) में नए फ़ील्ड, एट्रिब्यूट, और सुलभता के विकल्प शामिल हैं, ताकि लोगों को किसी जगह के बारे में ज़्यादा जानकारी दी जा सके. इन पहलुओं के बारे में नीचे दिए गए सेक्शन में बताया गया है.
फ़ील्ड
Places API (नया वर्शन) में कई नए फ़ील्ड शामिल होते हैं:
फ़ील्ड | जानकारी |
---|---|
regularSecondaryOpeningHours |
कुछ खास कार्रवाइयों के लिए खास समय के बारे में बताता है. दूसरे दर्जे के समय के खुलने का समय, किसी कारोबार के मुख्य समय से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट अपने खुले होने के समय के तौर पर, ड्राइव थ्रू या डिलीवरी के समय को अलग से बता सकता है. |
paymentOptions |
पैसे चुकाने के विकल्प, जो जगह स्वीकार करती है. किसी जगह पर पेमेंट के एक से ज़्यादा विकल्प
स्वीकार किए जा सकते हैं. अगर पेमेंट के विकल्प का डेटा उपलब्ध नहीं है, तो पेमेंट के विकल्प वाला फ़ील्ड सेट नहीं किया जाएगा. आपके पास ये विकल्प उपलब्ध होंगे:
|
parkingOptions |
जगह के हिसाब से पार्किंग के विकल्प. आपके पास ये विकल्प उपलब्ध होंगे:
|
subDestinations |
किसी खास जगह से जुड़े खास स्थान. उदाहरण के लिए, एयरपोर्ट टर्मिनल को किसी हवाई अड्डे का सब-डेस्टिनेशन माना जाता है. |
fuelOptions |
किसी पेट्रोल पंप पर उपलब्ध ईंधन के विकल्पों के बारे में
ताज़ा जानकारी. यह जानकारी नियमित रूप से अपडेट की ��ाती है. आपके पास ये विकल्प उपलब्ध
होंगे:
|
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 |
यहां बैठने के लिए व्हीलचेयर की सुविधा है. |
New Places API पर माइग्रेट करें
अगर आप मौजूदा Places API ग्राहक हैं और आपको एपीआई के नए इस्तेमाल के लिए, अपने ऐप्लिकेशन को माइग्रेट करना है, तो माइग्रेशन से जुड़ा यह दस्तावेज़ देखें: