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

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

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

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

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

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

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

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

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

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

टेक्स्ट की मदद से खोजने की सुविधा (नई) और आस-पास की जगहों की जानकारी (नई)

Places API में दो सर्च एपीआई शामिल हैं:

  • टेक्स्ट खोज (नई सुविधा)

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

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

  • आस-पास खोजने की सुविधा (नया)

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

    एक या एक से ज़्यादा ऐसे जगहों के बारे में बताएं जो जगह. उदाहरण के लिए, किसी तय इलाके के शॉपिंग मॉल में मौजूद पिज़्ज़ा रेस्टोरेंट खोजने के लिए, "pizza_restaurant" और "shopping_mall" डालें.

दोनों खोजों में मुख्य अंतर यह है कि टेक्स्ट सर्च (नया) की मदद से एक आर्बिट्रेरी खोज स्ट्रिंग बताता है जबकि Nearby Search (नया) के लिए वह क्षेत्र है जिसमें खोजना है.

ऑटोकंप्लीट (नया) और सेशन टोकन

ऑटोकंप्लीट (नई) एक ऐसी वेब सेवा है जो जगह के अनुमान और एक HTTP अनुरोध के जवाब में क्वेरी पूर्वानुमान. अनुरोध में, टेक्स्ट खोज स्ट्रिंग और भौगोलिक सीमाओं की जानकारी दें. इससे खोज के लिए चुने गए इलाके को कंट्रोल किया जा सकता है.

सेशन टोकन, उपयोगकर्ता की जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नए) कॉल को इस तौर पर ट्रैक करती हैं सत्र. ऑटोकंप्लीट (नया) सुविधा, क्वेरी को ग्रुप करने के लिए सेशन टोकन का इस्तेमाल करती है और के लिए डिस्क्रीट सेशन में उपयोगकर्ता ऑटोकंप्लीट खोज के चुनने के चरण बिलिंग उद्देश्यों के लिए किया जा सकता है.

नए फ़ील्ड, एट्रिब्यूट, और सुलभता के विकल्प

Places API (नया वर्शन) में नए फ़ील्ड, एट्रिब्यूट, और सुलभता के विकल्प शामिल हैं का इस्तेमाल करें. इन पहलुओं के बारे में, नीचे दिए गए सेक्शन में बताया गया है.

फ़ील्ड

Places API (नया वर्शन) में कई नए फ़ील्ड शामिल होते हैं:

फ़ील्ड ब्यौरा
regularSecondaryOpeningHours कुछ खास कार्रवाइयों के लिए खास समय के बारे में बताता है. कारोबार के खुले होने का दूसरा समय, मुख्य समय से अलग होता है. इसके लिए उदाहरण के लिए, कोई रेस्टोरेंट ड्राइव थ्रू घंटे या डिलीवरी की जानकारी दे सकता है घंटे के दूसरे घंटे के रूप में शामिल किया जाता है.
paymentOptions पैसे चुकाने के विकल्प, जो जगह स्वीकार करती है. कोई जगह इससे ज़्यादा स्वीकार की जा सकती है एक भुगतान विकल्प का उपयोग करना होगा. अगर पेमेंट के विकल्प का डेटा उपलब्ध नहीं है, तो पेमेंट के विकल्प का फ़ील्ड अनसेट कर दिया जाएगा. इनमें ये विकल्प शामिल हैं:
  • क्रेडिट कार्ड
  • डेबिट कार्ड
  • केवल नकद
  • एनएफ़सी पेमेंट
parkingOptions जगह के हिसाब से पार्किंग के विकल्प. आपके पास ये विकल्प उपलब्ध होंगे:
  • मुफ़्त पार्किंग स्थल
  • पार्किंग की सुविधा के लिए पैसे चुकाने होंगे
  • सड़क के किनारे मुफ़्त पार्किंग की सुविधा है
  • वैले पार्किंग की सुविधा
  • गराज में मुफ़्त पार्किंग की सुविधा
  • गैराज में पार्किंग की सुविधा के लिए पैसे चुकाने होंगे
subDestinations किसी खास जगह से जुड़े खास स्थान. उदाहरण के लिए, हवाई अड्डे के टर्मिनल को हवाई अड्डे के उप-डेस्टिनेशन माना जाता है.
fuelOptions किसी पेट्रोल पंप पर उपलब्ध ईंधन के विकल्पों के बारे में सबसे नई जानकारी. यह जानकारी नियमित तौर पर अपडेट की जाती है. विकल्पों में ये शामिल हैं:
  • डीज़ल
  • रेगुलर अनलेड
  • मिडग्रेड
  • प्रीमियम
  • SP91
  • एसपी91 ई10
  • 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 यहां बैठने के लिए व्हीलचेयर की सुविधा है.

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

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