क्षेत्रों को खोजने और जगहों के बारे में ज़्यादा जानकारी पाने के लिए, Android के लिए Maps SDK के साथ Places सेवा और Geocoding API का इस्तेमाल किया जा सकता है. Places सेवा और Geocoding API, Google Workspace for Education Plus जगह के आईडी. अगर पहले से ही जगह के आईडी इस्तेमाल किए जा रहे हैं, तो उन आईडी को डेटा-ड्रिवन स्टाइलिंग का इस्तेमाल करें.
Android ऐप्लिकेशन के लिए Maps SDK टूल में, जगहों की जानकारी देने वाली सेवा और जियोकोडिंग की सुविधा को इन तरीकों से जोड़ें:
- Places SDK for Android एक Android लाइब्रेरी है. इसमें जगहों के बारे में जानकारी देने के तरीके शामिल हैं.
- Places API, एचटीटीपी रिक्वेस्ट का इस्तेमाल करके जगहों की जानकारी दिखाता है.
- जियोकोडर की क्लास उपयोगकर्ता के इनपुट से डाइनैमिक तौर पर जियोकोड और रिवर्स कर सकते हैं.
- Geocoding API की मदद से, स्टैटिक और जाने-पहचाने पतों को जियोकोड किया जा सकता है.
Places की सेवा का इस्तेमाल करना
जगह का आईडी ढूंढने के लिए, टेक्स्ट खोज (नया) का इस्तेमाल करना
इसके लिए, टेक्स्ट सर्च (नया) का इस्तेमाल करें
क्षेत्र के साथ जगह का आईडी पाने के लिए, Places API में REST API
डेटा देखने के लिए, फ़ील्ड मास्क में places.id
तय करें. प्लेस आईडी का अनुरोध करने के लिए, टेक्स्ट सर्च (नया) का इस्तेमाल करने पर कोई शुल्क नहीं लिया जाता. ज़्यादा जानें.
उदाहरण के लिए, कैलिफ़ोर्निया के ट्रिनिडाड की जगह का आईडी पाने के लिए, यह एपीआई कॉल किया जा सकता है:
curl -X POST -d '{ "textQuery" : "Trinidad, CA" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.id' \ 'https://places.googleapis.com/v1/places:searchText'
क्षेत्र ढूंढने के लिए, जगहों के लिए ऑटोकंप्लीट की सुविधा का इस्तेमाल करना
जगहों के बारे में ऑटोकंप्लीट की सुविधा
Android के लिए Places SDK में उपलब्ध सेवा
आपके उपयोगकर्ता क्षेत्रों की खोज करते हैं. जगहों की जानकारी अपने-आप भरने की सुविधा को सिर्फ़ इलाकों के लिए कॉन्फ़िगर करने के लिए, टाइप फ़िल्टर को PlaceTypes.REGIONS
पर सेट करने के लिए, AutocompleteSupportFragment.setTypesFilter(List)
का इस्तेमाल करें.
किसी क्षेत्र के लिए जगह की जानकारी पाएं
जगह की जानकारी Android के लिए Places SDK में उपलब्ध सेवा की मदद से, किसी क्षेत्र के लिए डेटा वापस भेजा जाता है काफ़ी उपयोगी होते हैं. उदाहरण के लिए:
- जगह के नाम के आधार पर सीमा से जुड़े जगह के आईडी खोजें.
- सीमा पर ज़ूम करने के लिए व्यूपोर्ट पाएं.
- सीमा के लिए फ़ीचर टाइप (उदाहरण के लिए,
locality
) पाएं. - फ़ॉर्मैट किया गया पता पाएं, जो अमेरिका के इलाके में "जगह का नाम, राज्य, देश" के तौर पर दिखता है. उदाहरण के लिए, "ओटमुवा, आईए, अमेरिका".
- काम के अन्य डेटा (जैसे, फ़ोटो) पाएं.
Geocoding API का इस्तेमाल करना
Geocoding API की मदद से, किसी पते को अक्षांश और देशांतर के निर्देशांकों और प्लेस आईडी में बदला जा सकता है. इसके अलावा, अक्षांश और देशांतर के निर्देशांकों या प्लेस आईडी को पते में बदला जा सकता है. नीचे दिए गए सीमाओं के लिए डेटा-ड्रिवन स्टाइलिंग के साथ अच्छी तरह से कंबाइंड किया जा सकता है:
- किसी इलाके का व्यूपोर्ट पाने के लिए, जियोकोडिंग का इस्तेमाल करें.
- अपने जियोकोडिंग कॉल में कॉम्पोनेंट को फ़िल्टर करने की सुविधा लागू करें, ताकि आप इसके लिए जगह के आईडी पा सकें राज्य 1-4, शहर या पिन कोड.
- अक्षांश और देशांतर निर्देशांक के हिसाब से जगह के आईडी ढूंढने के लिए, रिवर्स जियोकोडिंग का इस्तेमाल करें. इसके अलावा, किसी खास जगह के सभी कॉम्पोनेंट के लिए जगह के आईडी भी पाएं.
इस उदाहरण में, यूआरएल-एस्केप किए गए पते का इस्तेमाल करके, Geocoding API को अनुरोध भेजा गया है:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY
जगह के आईडी ढूंढने के लिए, रिवर्स जियोकोडिंग का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में, जियोकोडिंग सेवा फ़ंक्शन, दिए गए अक्षांश और देशांतर निर्देशांक पर पते के सभी कॉम्पोनेंट के लिए प्लेस आईडी दिखाता है:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
पते के कॉम्पोनेंट पाने के लिए, कॉम्पोनेंट को फ़िल्टर करने के साथ रिवर्स जियोकोडिंग का इस्तेमाल करें किसी तय जगह पर, इनमें से एक या ज़्यादा टाइप के लिए:
administrativeArea
country
locality
postalCode
उदाहरण के तौर पर दिया गया अगला फ़ंक्शन, जियोकोडिंग सेवा का इस्तेमाल करके कॉम्पोनेंट जोड़ता है
इसके साथ ही रिवर्स जियोकोडिंग के साथ प्रतिबंध है, जो कि
सिर्फ़ locality
टाइप के लिए जगह की जानकारी:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY