क्षेत्रों को खोजने और जगहों के बारे में ज़्यादा जानकारी पाने के लिए, Android के लिए Maps SDK के साथ Places सेवा और Geocoding API का इस्तेमाल किया जा सकता है. जगह की जानकारी वाली सेवा और जियोकोडिंग एपीआई, जगह का आईडी पाने के लिए बेहतर और भरोसेमंद विकल्प हैं. अगर पहले से ही जगह के आईडी का इस्तेमाल किया जा रहा है, तो सीमाओं के लिए डेटा-ड्रिवन स्टाइल के साथ उन आईडी का फिर से इस्तेमाल किया जा सकता है.
Android ऐप्लिकेशन के लिए Maps SDK टूल में, जगहों की जानकारी देने वाली सेवा और जियोकोडिंग की सुविधा को इन तरीकों से जोड़ें:
- Places SDK for Android एक Android लाइब्रेरी है. इसमें जगहों के बारे में जानकारी देने के तरीके शामिल हैं.
- Location 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'
इलाके ढूंढने के लिए, जगहों के नाम अपने-आप पूरे होने की सुविधा का इस्तेमाल करना
Places SDK for Android में जगहों के नाम अपने-आप पूरे होने की सुविधा, आपके उपयोगकर्ताओं को इलाकों को खोजने का आसान तरीका उपलब्ध कराती है. स्थान ऑटोकंप्लीट सेवा को कॉन्फ़िगर करने के लिए
सिर्फ़ क्षेत्रों को दिखाएं,
AutocompleteSupportFragment.setTypesFilter(List)
टाइप फ़िल्टर को PlaceTypes.REGIONS
पर सेट करने के लिए.
किसी क्षेत्र के लिए जगह की जानकारी पाएं
जगह की जानकारी Android के लिए Places SDK में उपलब्ध सेवा की मदद से, किसी क्षेत्र के लिए डेटा वापस भेजा जाता है काफ़ी उपयोगी होते हैं. उदाहरण के लिए:
- जगह के नाम के आधार पर, सीमा के प्लेस आईडी खोजें.
- सीमा पर ज़ूम करने के लिए व्यूपोर्ट पाएं.
- सीमा के लिए सुविधा का टाइप पाएं (उदाहरण के लिए
locality
). - फ़ॉर्मैट किया गया पता पाएं, जो अमेरिका के इलाके में "जगह का नाम, राज्य, देश" के तौर पर दिखता है. उदाहरण के लिए, "ओटमुवा, आईए, अमेरिका".
- फ़ोटो जैसा अन्य काम का डेटा पाएं.
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