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

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

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

Android ऐप्लिकेशन के लिए Maps SDK टूल में, जगहों की जानकारी देने वाली सेवा और जियोकोडिंग की सुविधा को इन तरीकों से जोड़ें:

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

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

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

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