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

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 किसी पेट्रोल पंप पर उपलब्ध ईंधन के विकल्पों के बारे में ताज़ा जानकारी. यह जानकारी नियमित रूप से अपडेट की जाती है. आपके पास ये विकल्प उपलब्ध होंगे:
  • डीज़ल
  • रेगुलर अनलीडेड
  • मिडग्रेड
  • प्रीमियम
  • SP91
  • एसपी91 ई10
  • SP92
  • एसपी95 ई10
  • 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 यहां बैठने के लिए व्हीलचेयर की सुविधा है.

New Places API पर माइग्रेट करें

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