नए स्थान API के बारे में जानकारी

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

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

जगह की जानकारी का एपीआई

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

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

जगह की फ़ोटो का एपीआई

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

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

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

टेक्स्ट खोज और आस-पास की खोज

Places API में दो खोज एपीआई शामिल हैं:

  • टेक्स्ट खोज (नई)

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

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

  • आस-पास खोज (नई)

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

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

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

एपीआई और सेशन टोकन अपने-आप पूरा होने की सुविधा

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

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

नए फ़ील्ड, विशेषताएं, और सुलभता विकल्प

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 यहां बैठने के लिए व्हीलचेयर की सुविधा है.

नए स्थान API पर माइग्रेट करें

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