مخطط المبنى هو مجموعة من أزواج إحداثيات خطوط الطول/العرض التي تحدد مضلّع ثنائي الأبعاد يمثل مساحة سطح الأرض التي يغطيها المبنى. يمكنك استخدام هذا المضلّع لرسم مخطط مبنى على الخريطة. المدخل هو زوج واحد من إحداثيات خط العرض/الطول يحدد موقع مدخل ونقطة خروج إلى مكان؛ على سبيل المثال، باب المبنى.
المَعلمات الإضافية
تضمين
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.