खास जानकारी

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा
Places API एक ऐसी सेवा है जो कई तरीकों से जगह की जानकारी के डेटा के लिए, एचटीटीपी अनुरोधों को स्वीकार करती है. इससे फ़ॉर्मैट किया गया स्थान डेटा, जगहों, भौगोलिक जगहों या दिलचस्पी की खास जगहों की तस्वीरें दिखती हैं.

Places API का इस्तेमाल क्यों करें

जगह की जानकारी की सुविधा बनाएं, ताकि आपके उपयोगकर्ताओं को जगह की पूरी जानकारी का डेटा आसानी से उपलब्ध कराया जा सके. Places API से उपलब्ध डेटा वास्तविक दुनिया के सबसे सटीक और अप-टू-डेट और व्यापक स्थान मॉडल में से किसी एक पर बनाया गया है. ऐप्लिकेशन के लिए, इस्तेमाल के उदाहरण यहां दिए गए हैं:

  • मुख्य महानगरीय क्षेत्रों में, खास तौर पर शहरों के लिए टारगेट किए गए नतीजों में किराये पर मिलने वाले अपार्टमेंट देखें.
  • पिक अप या डिलीवरी की स्थिति के अपडेट में जगह की जानकारी शामिल करें.
  • किसी इलाके के पार्क की सूची दिखाने के लिए, उपयोगकर्ता की सबमिट की गई फ़ोटो और समीक्षाएं देखें.
  • रास्ते में पड़ने वाली जगहों के लिए संपर्क जानकारी, समीक्षाओं, और कीमत के लेवल की जानकारी देने वाले लोगों को जानकारी दें.

आप Places API के साथ क्या कर सकते हैं

अपने ऐप्लिकेशन में नीचे दी गई सुविधाएं शामिल करने के लिए, Places एपीआई का इस्तेमाल किया जा सकता है:

  • उपयोगकर्ता की अलग-अलग तरह की क्वेरी से, जगह के हिसाब से खोज के नतीजे दें. जैसे, टेक्स्ट डालने, आस-पास की जगहों की जानकारी, और साफ़ तौर पर समझ में न आने वाली या खास उपयोगकर्ता क्वेरी.
  • अलग-अलग तरह की खोज क्वेरी के लिए, ऑटोकंप्लीट की सुविधा चालू करें. यह सुविधा कुछ खास तरह की टेक्स्ट क्वेरी या किसी खास तरह की क्वेरी के लिए चालू की जा सकती है.
  • किसी जगह के बारे में दी गई जानकारी के टाइप को बेहतर बनाएं, जैसे कि कारोबार के खुले होने का समय, खास जानकारी, उपयोगकर्ता की समीक्षाएं, और कोई फ़ोटो.
  • आपके ऐप्लिकेशन से जुड़ी जगहों पर अच्छी क्वालिटी की फ़ोटो जोड़ें.

Places API कैसे काम करता है

Places API, अनुरोध को किसी खास सेवा एंडपॉइंट पर सामान्य यूआरएल के रूप में स्वीकार करता है, जैसे कि /place या /photo. एंडपॉइंट भी, अनुरोध में बताए गए फ़ॉर्मैट के साथ ही JSON या एक्सएमएल को भी स्वीकार करते हैं. आखिर में, सेवा का अनुरोध, उस खास एंडपॉइंट से जुड़े पैरामीटर का इस्तेमाल करता है, ताकि मिलने वाले डेटा को बेहतर बनाया जा सके. उदाहरण के लिए, पते के कॉम्पोनेंट के लिए, जगह की जानकारी के लिए यह अनुरोध इस तरह से काम करता है, कि यह JSON फ़ॉर्मैट में रिटर्न दिखाता है:

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

इस उदाहरण में, सेवा दिए गए जगह के आईडी का इस्तेमाल करके, अनुरोध की गई जगह ढूंढती है और JSON फ़ॉर्मैट में पते के कॉम्पोनेंट दिखाती है.

रिसॉर्स

इस टेबल में, एपीआई के ज़रिए उपलब्ध डेटा की खास जानकारी दी गई है. साथ ही, इसमें दिए गए डेटा की जानकारी भी दी गई है.

डेटा संसाधन डेटा लौटाया गया रिटर्न फ़ॉर्मैट
जगह की जानकारी खोजना डिवाइस की जगह या खोज स्ट्रिंग के आधार पर जगहों की सूची दिखाता है.

खोज के लिए डाले गए जवाबों, आस-पास के खोज के नतीजों, और टेक्स्ट के लिए खोज के जवाबों की जानकारी देखें.

  • JSON
  • एक्सएमएल
जगह की जानकारी किसी खास जगह के बारे में ज़्यादा जानकारी दिखाता है. इसमें उपयोगकर्ताओं की समीक्षाएं भी शामिल हैं.

जगह के बारे में जानकारी से जुड़े रिस्पॉन्स देखें.

  • JSON
  • एक्सएमएल
जगहों की फ़ोटो Google के जगह की जानकारी वाले डेटाबेस में सेव की गई लाखों जगहों की फ़ोटो का ऐक्सेस देता है.

जगहों के बारे में ग्राहकों की राय के लिए जानकारी देखें.

  • JSON
  • एक्सएमएल
जगह की जानकारी अपने-आप पूरी होना उपयोगकर्ता का नाम डालते ही उस जगह का नाम और/या पता अपने-आप भर जाता है.

अपने-आप पूरा होने वाले जवाब डालें की जानकारी देखें.

  • JSON
  • एक्सएमएल
क्वेरी ऑटोकंप्लीट करने की सुविधा यह टेक्स्ट पर आधारित भौगोलिक खोजों के लिए, क्वेरी का अनुमान लगाने वाली सेवा देता है. साथ ही, उपयोगकर्ता के टाइप करने पर क्वेरी के सुझाव देता है.

क्वेरी के अपने-आप पूरे होने वाले जवाबों की जानकारी देखें.

  • JSON
  • एक्सएमएल

Places API को इस्तेमाल करने का तरीका

नीचे दिए गए चरणों में, स्पेस एपीआई सेवा में तीन एंडपॉइंट का इस्तेमाल करने के बारे में बताया गया है. अपना समाधान बनाते समय, आप आस-पास की खोज, जगह की फ़ोटो, और क्वेरी के अपने-आप भरने जैसे अतिरिक्त एंडपॉइंट का इस्तेमाल कर सकते हैं.
1 सेटअप करें सबसे पहले, अपना Google Cloud प्रोजेक्ट सेट अप करें. इसके बाद, सेट अप करने के निर्देशों का पालन करें और एपीआई पासकोड इस्तेमाल करने का तरीका जानें.
2 सामान्य टेक्स्ट खोजने की सुविधा आज़माएं एपीआई कुंजी मिलने के बाद, टेक्स्ट सर्च की गाइड में, बेसिक टेक्स्ट खोज के उदाहरणों में बताए गए तरीके से, एक आसान टेक्स्ट खोज जारी करें.
3 'ढूंढें' जगह की जानकारी के लिए अनुरोध का इस्तेमाल करना जगह के अनुरोध खोजें, जगह के आईडी के साथ-साथ आपके अनुरोध किए गए डेटा फ़ील्ड को भी दिखाते हैं. जैसे, कारोबार के खुले होने का समय, पता, और फ़ोटो. जगहों के उदाहरण देखें और इस्तेमाल के उदाहरण के हिसाब से एक और काम करने की कोशिश करें.
4 जगह की जानकारी खोजने के बारे में बुनियादी बातें समझना जगह ढूंढें का जवाब से मिला डेटा एक्सप्लोर करें. ज़्यादा जानकारी के लिए, जगह के बारे में जवाब खोजना देखें.
5 ज़्यादा जानकारी के लिए, जगह के आईडी का इस्तेमाल करना जगह के बारे में जवाब देने की सुविधा, किसी खास जगह के लिए उपलब्ध पूरा डेटा उपलब्ध नहीं कराती. किसी जगह के बारे में ज़्यादा जानकारी पाने के लिए, Find Find के रिस्पॉन्स में दिखाए गए जगह के आईडी का इस्तेमाल किया जा सकता है. जगह की जानकारी देखें.

उपलब्ध क्लाइंट लाइब्रेरी

इस एपीआई को इनमें से किसी एक क्लाइंट लाइब्रेरी की मदद से अपनी पसंद की भाषा में कॉल करें:

Google Maps की सेवाओं के लिए Java क्लाइंट, Python क्लाइंट, Go Client, और Node.js क्लाइंट, समुदाय के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. इन्हें ओपन सोर्स के तौर पर Apache 2.0 लाइसेंस के तहत लिया जाता है. उन्हें GitHub से डाउनलोड करें, जहां आपको इंस्टॉलेशन के निर्देश और सैंपल कोड भी मिल सकते हैं.

आगे क्या