सीमाओं के लिए डेटा-ड्रिवन स्टाइल के साथ Places Service और Geocoding API का इस्तेमाल करना

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

क्षेत्रों को खोजने और जगहों के बारे में ज़्यादा जानकारी पाने के लिए, Maps SDK for Android के साथ Places Service और Geocoding API का इस्तेमाल किया जा सकता है. जगह का आईडी पाने के लिए, Places Service और Geocoding API बेहतर और भरोसेमंद विकल्प हैं. अगर पहले से ही जगह के आईडी का इस्तेमाल किया जा रहा है, तो सीमाओं के लिए डेटा-ड्रिवन स्टाइल के साथ उन आईडी का फिर से इस्तेमाल किया जा सकता है.

Places Service और जियोकोडिंग को, Maps SDK for Android ऐप्लिकेशन में इन तरीकों से जोड़ें:

  • Places SDK for Android एक Android लाइब्रेरी है. इसमें जगहों के बारे में जानकारी देने वाले तरीके शामिल हैं.
  • Places API, एचटीटीपी रिक्वेस्ट का इस्तेमाल करके जगहों की जानकारी दिखाता है.
  • Geocoder class उपयोगकर्ता के इनपुट से डाइनैमिक तौर पर जियोकोड और रिवर्स जियोकोड कर सकती है.
  • Geocoding API की मदद से, स्टैटिक और जाने-पहचाने पतों को जियोकोड किया जा सकता है.

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

जगह का आईडी ढूंढने के लिए, टेक्स्ट खोज (नई) का इस्तेमाल करना

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 में जगहों के नाम अपने-आप पूरे होने की सुविधा, आपके उपयोगकर्ताओं को इलाकों को खोजने का आसान तरीका उपलब्ध कराती है. जगहों की जानकारी अपने-आप पूरी होने की सुविधा को कॉन्फ़िगर करके, सिर्फ़ इलाकों की जानकारी दिखाने के लिए, टाइप फ़िल्टर को PlaceTypes.REGIONS पर सेट करने के लिए, AutocompleteSupportFragment.setTypesFilter(List) का इस्तेमाल करें.

किसी इलाके की जगह की जानकारी पाना

Places SDK for Android में जगह की जानकारी सेवा, किसी इलाके का डेटा दिखाती है. यह डेटा काफ़ी काम का हो सकता है. उदाहरण के लिए:

  • जगहों के नाम के आधार पर, सीमा के प्लेस आईडी खोजें.
  • किसी सीमा पर ज़ूम करने के लिए व्यूपोर्ट पाएं.
  • सीमा के लिए फ़ीचर टाइप (उदाहरण के लिए 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