مخطّط المبنى هو مجموعة من أزواج إحداثيات خط العرض/خط الطول التي تحدّد ضلعًا ثنائي الأبعاد يمثّل مساحة سطح الأرض التي يغطيها المبنى. يمكنك استخدام هذا المضلّع لرسم مخطط مبنى على الخريطة. المدخل هو زوج واحد من إحداثيات خط العرض/خط الطول يحدّد موقع نقطة الدخول والخروج إلى مكان معيّن، مثل باب مبنى.
المَعلمات الإضافية
تضمين
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 للشكل المثلث العميق الذي يقترب من مساحة سطح الأرض التي يغطّيها المبنى، باستخدام تنسيق RFC 7946. لاحظ أن تنسيق RFC 7946 يدعم المضلعات المتعددة، وبالتالي يمكن أن يمثل كائنdisplay_polygon
واحد مضلّعات متعددة.
التغطية
هذه الميزة متاحة في جميع المناطق. ولكن لن تحتوي جميع المباني والمخططات العامة أو المداخل، وستختلف التغطية حسب المنطقة. بالإضافة إلى ذلك، من المفترض أن تتلقّى ردودًا من واجهة برمجة التطبيقات تحتوي على مخطّط المبنى بدون البوابات. ومن المتوقّع أن تتحسن تغطية مرات الدخول بمرور الوقت.
ملاحظات
هذه ميزة تجريبية. تسرّنا معرفة ملاحظاتك على buildings-in-geocoding-feedback-channel@google.com.