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

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

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

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

  • Places SDK for Android, Android लाइब्रेरी है. इसमें जगहों के बारे में जानकारी देने वाले तरीके शामिल हैं.
  • Places API, एचटीटीपी अनुरोधों का इस्तेमाल करके जगहों के बारे में जानकारी देता है.
  • Geocoder क्लास, उपयोगकर्ता के इनपुट के आधार पर डाइनैमिक तरीके से जियोकोड और रिवर्स जियोकोड कर सकती है.
  • 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'

जगहें ढूंढने के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करना

Android के लिए Places SDK में मौजूद जगहों के नाम अपने-आप पूरे होने की सुविधा, उपयोगकर्ताओं को आसानी से इलाके खोजने की सुविधा देती है. सिर्फ़ क्षेत्र की जानकारी पाने के लिए, Places Autocomplete सेवा को कॉन्फ़िगर करने के लिए, AutocompleteSupportFragment.setTypesFilter(List) का इस्तेमाल करें. इससे टाइप फ़िल्टर को PlaceTypes.REGIONS पर सेट किया जा सकता है.

किसी इलाके की जगहों के बारे में जानकारी पाना

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

अगले उदाहरण फ़ंक्शन में, Geocoding सेवा का इस्तेमाल करके दिखाया गया है. इसमें, सिर्फ़ locality टाइप के लिए, बताई गई जगह के सभी पते के कॉम्पोनेंट पाने के लिए, रिवर्स जियोकोडिंग के साथ कॉम्पोनेंट की पाबंदियां जोड़ी गई हैं:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY