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

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

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

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

  • 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'

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

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

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

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

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

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

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