Places API (नया वर्शन) में ये एपीआई शामिल हैं:
- जगह की जानकारी (नई)
- जगह की फ़ोटो (नई)
- आस-पास खोजने की सुविधा (नया)
- टेक्स्ट खोज (नई सुविधा)
- ऑटोकंप्लीट की सुविधा (नई सुविधा)
इस दस्तावेज़ में इन नए एपीआई की खास जानकारी शामिल है.
जगह की जानकारी (नई)
स्थान आईडी Google स्थल डेटाबेस में और किसी स्थान की खास तौर पर पहचान करता है Google मैप. जगह के आईडी की मदद से, किसी खास जगह की जानकारी का अनुरोध किया जा सकता है जगह की जानकारी (नई) की शुरुआत करके, कारोबार या लोकप्रिय जगह की जानकारी अनुरोध. किसी जगह की जानकारी (नया) पाने का अनुरोध करने पर, किसी जगह के बारे में पूरी जानकारी मिलती है बताई गई जगह, जैसे कि उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएँ.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट खोज (नई सुविधा)
- आस-पास खोजने की सुविधा (नया)
- जियोकोडिंग एपीआई
- रूट एपीआई
- पते की पुष्टि करने वाला एपीआई
- जगह की जानकारी के अपने-आप पूरे होने की सुविधा
जगह की फ़ोटो (नई)
जगह की फ़ोटो (नया) एपीआई की मदद से, अच्छी क्वालिटी का फ़ोटोग्राफ़िक कॉन्टेंट जोड़ा जा सकता है आपको सेव की गई लाखों फ़ोटो की ऐक्सेस देकर, आपके ऐप्लिकेशन को Google स्थल डेटाबेस. स्थल फ़ोटो (नया) API का उपयोग करके, आप फ़ोटो अपलोड कर सकता है और चित्र का आकार अपने ऐप्लिकेशन के लिए इष्टतम आकार में बदल सकता है.
जगह की फ़ोटो (नया) एपीआई के सभी अनुरोधों में फ़ोटो संसाधन नाम, इससे फ़ोटो की पहचान होती है. फ़ोटो रिसॉर्स पाने के लिए, नाम डालें:
किसी जगह की जानकारी (नई) से जवाब में फ़ोटो संसाधन का नाम शामिल करने के लिए,
टेक्स्ट से खोजें (नया) या आस-पास की खोज (नया) का अनुरोध करते समय, पक्का करें कि आपने
अनुरोध के फ़ील्ड मास्क में photos
फ़ील्ड को.
टेक्स्ट से खोजें (नई) और आस-पास की खोज (नई)
Places API में दो खोज एपीआई होते हैं:
-
इससे आपको एक टेक्स्ट स्ट्रिंग तय करने की सुविधा मिलती है, जिस पर किसी जगह को खोजना है. जैसे: "ऑस्ट्रेलिया के सिडनी में मसालेदार शाकाहारी खाना" या "इसके पास बढ़िया सी-फ़ूड डाइनिंग है Palo Alto, CA".
बेहतर खोज के लिए, कीमत लेवल, खुलने की मौजूदा स्थिति, रेटिंग या खास तरह की जगहों के बारे में जानकारी. आप यह भी कर सकते हैं नतीजों में किसी खास जगह के हिसाब से नतीजे दिखाने या खोज को सीमित करने के लिए किसी खास जगह के लिए.
-
इससे आपको जगहों के टाइप की सूची के साथ खोजने के लिए, किसी इलाके का नाम बताने की सुविधा मिलती है. क्षेत्र के बारे में अक्षांश और देशांतर के हिसाब से बताने वाले सर्कल के तौर पर बताएं मीटर में केंद्र बिंदु और त्रिज्या के निर्देशांक.
एक या एक से ज़्यादा ऐसे जगहों के बारे में बताएं जो जगह. उदाहरण के लिए, तय करें "
pizza_restaurant
" और "shopping_mall
" से किसी शॉपिंग मॉल में मौजूद पिज़्ज़ा रेस्टोरेंट को खोजो क्षेत्र.
दोनों खोजों में मुख्य अंतर यह है कि टेक्स्ट सर्च (नया) की मदद से एक आर्बिट्रेरी खोज स्ट्रिंग बताता है जबकि Nearby Search (नया) के लिए जिसमें खोजना है.
ऑटोकंप्लीट (नया) और सेशन टोकन
ऑटोकंप्लीट (नई) एक ऐसी वेब सेवा है जो जगह के अनुमान और एक HTTP अनुरोध के जवाब में क्वेरी पूर्वानुमान. अनुरोध में कोई टेक्स्ट डालें खोज स्ट्रिंग और भौगोलिक सीमाएं शामिल होती हैं, जो खोज क्षेत्र को नियंत्रित करती हैं.
सेशन टोकन, उपयोगकर्ता की जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नए) कॉल को इस तौर पर ट्रैक करती हैं सत्र. ऑटोकंप्लीट (नया) सुविधा, क्वेरी को ग्रुप करने के लिए सेशन टोकन का इस्तेमाल करती है और के लिए डिस्क्रीट सेशन में उपयोगकर्ता ऑटोकंप्लीट खोज के चुनने के चरण बिलिंग उद्देश्यों के लिए किया जा सकता है.
नए फ़ील्ड, एट्रिब्यूट, और सुलभता के विकल्प
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 ग्राहक हैं और अपने ऐप्लिकेशन को नए API का उपयोग करने के लिए, निम्न माइग्रेशन दस्तावेज़ देखें: