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