पता डिस्क्रिप्टर, स्टैंडर्ड रिवर्स जियोकोडिंग रिस्पॉन्स को ज़्यादा जानकारी देते हैं. इससे लैंडमार्क और इलाकों का इस्तेमाल करके अक्षांश और देशांतर निर्देशांकों का ब्यौरा देने में मदद मिलती है. एपीआई के बारे में जानने के लिए, पता डिस्क्रिप्टर का डेमो देखें.
रिवर्स जियोकोडिंग अनुरोध - अतिरिक्त पैरामीटर
ज़रूरी नहीं पैरामीटर
ये ऐसे वैकल्पिक पैरामीटर हैं जिन्हें रिवर्स जियोकोडिंग अनुरोध में शामिल किया जा सकता है:
enable_address_descriptor— यह एक बूलियन पैरामीटर है, जिसे रिवर्स जियोकोडिंग अनुरोध के साथ शामिल किया जाता है, ताकि पता डिस्क्रिप्टर को स्टैंडर्ड रिवर्स जियोकोडिंग रिस्पॉन्स में जोड़ा जा सके.
रिवर्स जियोकोडिंग का उदाहरण
नीचे दी गई क्वेरी में, दिल्ली की किसी जगह की अक्षांश/देशांतर वैल्यू शामिल है:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
जवाब
ऊपर दी गई क्वेरी एक अतिरिक्त address_descriptor दिखाती है, जो इस तरह है:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
हर address_descriptor ऑब्जेक्ट में दो कलेक्शन होते हैं: landmarks और
areas. landmarks कलेक्शन में, अनुरोध किए गए कोऑर्डिनेट से नज़दीक होने, लैंडमार्क की मौजूदगी, और इसके दिखने के क्रम को ध्यान में रखते हुए, रैंक किए गए ज़्यादा से ज़्यादा पांच नतीजे शामिल होते हैं. हर लैंडमार्क नतीजे में ये वैल्यू शामिल होती हैं:
place_id, लैंडमार्क नतीजे का जगह का आईडी है. जगह के आईडी के बारे में खास जानकारी देखें.display_name, लैंडमार्क का डिसप्ले नेम है. इसमेंlanguage_codeऔरtextशामिल हैं.- इनपुट निर्देशांक और लैंडमार्क के नतीजे के बीच की दूरी, मीटर में बताने के लिए
straight_line_distance_metersपॉइंट है. travel_distance_metersइनपुट निर्देशांक और लैंडमार्क नतीजे के बीच सड़क नेटवर्क से होते हुए (सड़क की पाबंदियों को अनदेखा करते हुए) तय की गई दूरी मीटर में होती है.spatial_relationship, इनपुट निर्देशांक और लैंडमार्क के नतीजे के बीच का अनुमानित संबंध है:- जब इनमें से कोई भी बात लागू नहीं होती, तो
"NEAR"डिफ़ॉल्ट संबंध के तौर पर सेट हो जाता है. "WITHIN"जब इनपुट निर्देशांक, लैंडमार्क से जुड़े स्ट्रक्चर की सीमाओं में होता है."BESIDE"जब इनपुट निर्देशांक, लैंडमार्क या लैंडमार्क के ऐक्सेस पॉइंट के ठीक पास हो."ACROSS_THE_ROAD"जब इनपुट कोऑर्डिनेट रास्ते की दूसरी ओर मौजूद लैंडमार्क के ठीक सामने होता है."DOWN_THE_ROAD"जब इनपुट कोऑर्डिनेट उसी रास्ते पर हो जिसके पास लैंडमार्क है, लेकिन"BESIDES"या"ACROSS_THE_ROAD"नहीं."AROUND_THE_CORNER"जब इनपुट कोऑर्डिनेट, लैंडमार्क के रूप में लंबवत रास्ते पर हो (सिर्फ़ एक मोड़ तक सीमित)."BEHIND"जब इनपुट कोऑर्डिनेट जगह के हिसाब से लैंडमार्क के पास होता है, लेकिन ऐक्सेस पॉइंट से दूर होता है.types, लैंडमार्क के जगह के टाइप हैं.
areas ऑब्जेक्ट में ज़्यादा से ज़्यादा तीन रिस्पॉन्स होते हैं. यह सिर्फ़ ऐसी जगहों तक सीमित होता है जो छोटे इलाकों से जुड़ी होती हैं, जैसे कि आस-पड़ोस, इलाके, और बड़े इलाके. जिन क्षेत्रों में अनुरोध किए गए निर्देशांक होते हैं उन्हें पहले सूची में रखा जाता है और
छोटे से सबसे बड़े के क्रम में रखा जाता है. हर areas नतीजे में ये वैल्यू शामिल होती हैं:
place_id, इलाके के नतीजे का जगह का आईडी है. जगह के आईडी के बारे में खास जानकारी देखें.display_name, इलाके का डिसप्ले नेम है. इसमेंlanguage_codeऔरtextशामिल हैं.containment, इनपुट निर्देशांक और इलाकों के नतीजे के बीच कंटेनमेंट का अनुमानित संबंध है:- जब इनमें से कोई भी बात लागू नहीं होती, तो
"NEAR"डिफ़ॉल्ट संबंध के तौर पर सेट हो जाता है. "WITHIN". ऐसा तब होता है, जब इनपुट कोऑर्डिनेट, एरिया के बीच में होता है."OUTSKIRTS". जब इनपुट कोऑर्डिनेट, क्षेत्रफल के किनारे के पास हो.
कवरेज
यह सुविधा सिर्फ़ चुनिंदा देशों में उपलब्ध है.
सुझाव/राय दें या शिकायत करें
इस सुविधा को फ़िलहाल आज़माया जा रहा है. इसलिए, अगर आपको सुझाव या राय देनी है या शिकायत करनी है, तो हमें बताएं. कृपया हमें address-descriptors-feedback@google.com पर ईमेल करें.