इमारत की आउटलाइन, अक्षांश/देशांतर निर्देशांक जोड़ों का एक सेट है जो 2D पॉलीगॉन तय करते हैं. यह पॉलीगॉन इमारत से ढकी हुई पृथ्वी का सरफ़ेस एरिया दिखाता है. इस पॉलीगॉन का इस्तेमाल, मैप पर किसी इमारत की आउटलाइन करने के लिए किया जा सकता है. प्रवेश एक ऐसा अक्षांश/देशांतर निर्देशांक होता है जो किसी जगह पर आने और जाने की जगह के बारे में बताता है. उदाहरण के लिए, किसी इमारत का दरवाज़ा.
अतिरिक्त पैरामीटर
अपने जवाब में एंट्रेंस और इमारत की आउटलाइन पाने के लिए, जियोकोडिंग के अनुरोध,
रिवर्स जियोकोडिंग के अनुरोध या जगहों की जियोकोडिंग के अनुरोध में extra_computations=BUILDING_AND_ENTRANCES
शामिल करें.
अनुरोध का उदाहरण
नीचे दी गई क्वेरी संयुक्त राज्य अमेरिका के माउंटेन व्यू, कैलिफ़ोर्निया में किसी रेस्टोरेंट की इमारतों की आउटलाइन और प्रवेश की जानकारी देने की सुविधा चालू करती है:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY
जवाब का उदाहरण
ऊपर पूछी गई क्वेरी का जवाब इस तरह है:
{
"entrances": [
{
"location": {
"lat": 37.3925065,
"lng": -122.0799465
},
"building_place_id": "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
"buildings" : [
{
"building_outlines" : [
{
"display_polygon" : {
"coordinates" : [
[
[
-122.080188246116,
37.3926407183216
],
[
-122.080281351765,
37.3924887558601
],
[
-122.080023707261,
37.392390122414
],
[
-122.079926266852,
37.3925369491992
],
[
-122.080188246116,
37.3926407183216
]
]
],
"type" : "Polygon"
}
}
],
"place_id" : "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
}
इस सुविधा के चालू होने पर, दो कलेक्शन दिखाए जा सकते हैं:
buildings[]
और entrances[]
.
हर entrances
नतीजे में ये फ़ील्ड होते हैं:
location
प्रवेश द्वार के अक्षांश/देशांतर निर्देशांक होते हैं.building_place_id
, उस इमारत का स्थान आईडी है जिसमें अंदर जाने का रास्ता होता है. ध्यान दें कि यह पैरामीटर हमेशा पॉप्युलेट नहीं होगा.
हर buildings
नतीजे में ये फ़ील्ड होते हैं:
place_id
, इमारत का यूनीक आइडेंटिफ़ायर है. ज़्यादा जानकारी के लिए, जगह के आईडी की खास जानकारी देखें.building_outlines[]
, इमारत से जुड़ी आउटलाइन का ऐरे है. फ़िलहाल, इस ऐरे में सिर्फ़ एक एंट्री होगी.building_outlines[]
के हर ऑब्जेक्ट में ये फ़ील्ड होते हैं:display_polygon
, पॉलीगॉन की GeoJSON एन्कोडिंग है जो आरएफ़सी 7946 फ़ॉर्मैट का इस्तेमाल करके, इमारत के चारों तरफ़ फैली पृथ्वी के सरफ़ेस एरिया का अनुमान लगाती है. ध्यान दें कि आरएफ़सी 7946 फ़ॉर्मैट, मल्टी-पॉलीगॉन के साथ काम करता है. इसलिए, एकdisplay_polygon
ऑब्जेक्ट एक से ज़्यादा पॉलीगॉन को दिखा सकता है.
कवरेज
यह सुविधा सभी इलाकों में उपलब्ध है. हालांकि, सभी इमारतों की आउटलाइन या एंट्रेंस नहीं दिखेंगे. साथ ही, इलाके के हिसाब से कवरेज अलग-अलग होगी. इसके अलावा, आपको एपीआई से ऐसे रिस्पॉन्स मिल सकते हैं जिनमें इमारत की आउटलाइन तो हो, लेकिन कोई एंट्रेंस न हो. समय के साथ, एंट्रेंस कवरेज बेहतर होने की उम्मीद है.
सुझाव/राय दें या शिकायत करें
इस सुविधा को प्रयोग के तौर पर दिया जा रहा है. हम buildings-in-geocoding-feedback-channel@google.com पर जाकर आपके सुझाव, शिकायत या राय जानना चाहते हैं.