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

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

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

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

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

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

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

Places API में टेक्स्ट से खोजने की सुविधा (नई) वाले REST API का इस्तेमाल करके, जगह का ऐसा आईडी पाया जा सकता है जिसमें क्षेत्र का डेटा शामिल हो. इसके लिए, फ़ील्ड मास्क में places.id तय करें. जगह के आईडी का अनुरोध करने के लिए, सिर्फ़ Text Search (नया) का इस्तेमाल करने पर कोई शुल्क नहीं लगता. ज़्यादा जानें.

उदाहरण के लिए, कैलिफ़ोर्निया के ट्रिनिडाड शहर का प्लेस आईडी पाने के लिए, यह एपीआई कॉल करें:

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

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

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

  • जगह के नाम के आधार पर, सीमा के प्लेस आईडी खोजें.
  • किसी सीमा पर ज़ूम करने के लिए व्यूपोर्ट पाएं.
  • सीमा के लिए सुविधा टाइप पाएं (उदाहरण के लिए, locality).
  • फ़ॉर्मैट किया गया पता पाएं. यह पता, अमेरिका में "जगह का नाम, राज्य, देश" के हिसाब से होता है. उदाहरण के लिए, "ओटमवा, आयोवा, अमेरिका".
  • अन्य काम का डेटा पाएं, जैसे कि फ़ोटो.

Geocoding API का इस्तेमाल करना

Geocoding API की मदद से, किसी पते को अक्षांश और देशांतर के निर्देशांक और प्लेस आईडी में बदला जा सकता है. इसके अलावा, अक्षांश और देशांतर के निर्देशांक या प्लेस आईडी को पते में बदला जा सकता है. सीमाओं के लिए, डेटा के हिसाब से स्टाइल तय करने की सुविधा का इस्तेमाल इन कामों के लिए किया जा सकता है:

  • किसी इलाके के व्यूपोर्ट की जानकारी पाने के लिए, जियोकोडिंग का इस्तेमाल करें.
  • अपने जियोकोडिंग कॉल पर कॉम्पोनेंट फ़िल्टरिंग लागू करें, ताकि आपको प्रशासनिक क्षेत्र 1-4, इलाके या पिन कोड के लिए जगह के आईडी मिल सकें.
  • अक्षांश और देशांतर निर्देशांकों के हिसाब से जगह के आईडी ढूंढने के लिए, रिवर्स जियोकोडिंग का इस्तेमाल करें. इसके अलावा, किसी जगह के सभी कॉम्पोनेंट के लिए भी जगह के आईडी पाए जा सकते हैं.

इस उदाहरण में, जियोकोडिंग एपीआई से अनुरोध करने के लिए, पते (यूआरएल-एस्केप किया गया) का इस्तेमाल किया गया है:

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 टाइप के लिए, तय की गई जगह के सभी पते के कॉम्पोनेंट पाने के लिए, रिवर्स जियोकोडिंग के साथ कॉम्पोनेंट restrictions जोड़ने का तरीका बताया गया है:

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