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

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

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

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

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

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

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

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

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

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