खास जानकारी

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

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

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

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

Places API की मदद से क्या-क्या किया जा सकता है

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

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

कई Google Maps Platform API के लिए प्लेस आईडी इस्तेमाल किए जा सकते हैं, जहां जगह का आईडी Google Places के डेटाबेस और Google Maps पर खास तौर पर किसी जगह की पहचान करता है. जगह का आईडी पाने के कई तरीके हैं. जैसे, Places API से, लेकिन Geocoding API, Routes API, और Address Validation API से भी.

जगह का आईडी मिलने के बाद, किसी खास कारोबार या लोकप्रिय जगह के बारे में ज़्यादा जानकारी पाने के लिए, Places API का इस्तेमाल करें. जैसे- उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.

Places API का अपना वर्शन चुनें

Places API, एपीआई के दो वर्शन के साथ काम करता है: जगहें एपीआई, मौजूदा एपीआई हैं और जगहें एपीआई (नया), इस एपीआई के अगली-पीढ़ी के वर्शन हैं.

Places API (नया) के रिलीज़ होने पर, आपका पहला काम यह तय करना है कि API के किस सेट का इस्तेमाल करना है. यह तब सही है, जब आप नए ग्राहक हैं या मौजूदा ग्राहक हैं जो पहले से एपीआई का इस्तेमाल कर रहे हैं. दो एपीआई के बीच के अंतर को समझने के लिए, इस गाइड का इस्तेमाल करें.

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

Places API (नया प्रॉडक्ट)

Places API (नया) अनुरोधों को एक खास सर्विस एंडपॉइंट वाले स्टैंडर्ड यूआरएल के तौर पर स्वीकार करता है, जैसे कि /places या places:searchText और JSON का जवाब देता है. Places API (नया) एपीआई पासकोड और OAuth टोकन से अनुमति देने की सुविधा देता है. इस उदाहरण में, एपीआई पासकोड का इस्तेमाल करके, जगह की जानकारी के लिए अनुरोध किया गया है. इसमें एक जगह के आईडी के लिए, पते के कॉम्पोनेंट दिखाए जा सकते हैं:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

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 फ़ॉर्मैट में दिखाती है.

रिसॉर्स

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

Places API Places API (नया प्रॉडक्ट) ध्यान दें
जगह ढूंढें टेक्स्ट खोज (नई) जगह ढूंढें का कोई नया वर्शन उपलब्ध नहीं है. Text Search (नए) ने इसे बदल दिया है.
आस-पास की खोज आस-पास खोज (नई) मौजूदा एपीआई का इस्तेमाल करके, टेक्स्ट क्वेरी वाले सभी अनुरोधों को Text Search (नया) का इस्तेमाल करना चाहिए. इसकी वजह यह है कि Nearby Search (नई) सुविधा के लिए टेक्स्ट इनपुट नहीं किए जा सकते.
टेक्स्ट से खोजें टेक्स्ट खोज (नई)
जगह की जानकारी जगह की जानकारी (नई)
जगह की फ़ोटो जगह की नई फ़ोटो (नई)
जगहों का अपने-आप पूरा होना ऑटोकंप्लीट (नया) झलक
क्वेरी ऑटोकंप्लीट ऑटोकंप्लीट (नया) ऑटोकंप्लीट के प्रीव्यू वर्शन में जोड़ी गई क्षमताएं (नई)

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

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