مخططات المباني ومداخلها

مخطّط المبنى هو مجموعة من أزواج إحداثيات خط العرض/خط الطول التي تحدّد ضلعًا ثنائي الأبعاد يمثّل مساحة سطح الأرض التي يغطيها المبنى. يمكنك استخدام هذا المضلّع لرسم مخطط مبنى على الخريطة. المدخل هو زوج واحد من إحداثيات خط العرض/خط الطول يحدّد موقع نقطة الدخول والخروج إلى مكان معيّن، مثل باب مبنى.

المَعلمات الإضافية

تضمين 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.