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

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

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

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

  • 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