โครงร่างและทางเข้าของอาคาร

ขอบอาคารคือชุดคู่พิกัดละติจูด/ลองจิจูดที่กําหนดรูปหลายเหลี่ยม 2 มิติซึ่งแสดงพื้นที่ผิวของดินแดนที่อาคารบดบัง คุณสามารถใช้รูปหลายเหลี่ยมนี้เพื่อวาดโครงร่างของอาคารบนแผนที่ ทางเข้าเป็นคู่พิกัดละติจูด/ลองจิจูดคู่ที่กำหนดตำแหน่งของจุดเข้าและจุดออกไปยังสถานที่หนึ่งๆ ตัวอย่างเช่น ประตูของอาคาร

พารามิเตอร์เพิ่มเติม

รวม 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"
    }
  ],
}

ระบบจะแสดงผลอาร์เรย์ 2 รายการเมื่อเปิดใช้ฟีเจอร์นี้ ได้แก่ buildings[] และ entrances[]

ผลลัพธ์ entrances แต่ละรายการจะมีช่องต่อไปนี้

• location คือพิกัดละติจูด/ลองจิจูดของทางเข้า
• building_place_id คือรหัสสถานที่ของอาคารที่มีทางเข้า โปรดทราบว่าระบบอาจไม่ป้อนข้อมูลพารามิเตอร์นี้เสมอไป

ผลลัพธ์ buildings แต่ละรายการจะมีช่องต่อไปนี้

• place_id คือตัวระบุที่ไม่ซ้ำกันของอาคาร ดู ภาพรวมรหัสสถานที่ สำหรับรายละเอียดเพิ่มเติม
• building_outlines[] คืออาร์เรย์ของโครงร่างที่เกี่ยวข้องกับอาคาร ปัจจุบันอาร์เรย์นี้จะมีเพียงรายการเดียว ออบเจ็กต์แต่ละรายการใน building_outlines[] จะมีช่องต่อไปนี้
• display_polygon คือการเข้ารหัส GeoJSON ของรูปหลายเหลี่ยมซึ่งประมาณพื้นที่ผิวของดินแดนที่อาคารบดบังโดยใช้รูปแบบ RFC 7946 โปรดทราบว่ารูปแบบ RFC 7946 รองรับรูปหลายเหลี่ยมหลายรูป ดังนั้นออบเจ็กต์ display_polygon 1 รายการจึงแสดงรูปหลายเหลี่ยมหลายรูปได้

ความครอบคลุม

ฟีเจอร์นี้พร้อมให้บริการในทุกภูมิภาค แต่อาคารบางแห่งอาจไม่มีขอบหรือทางเข้า และอาจครอบคลุมไม่เท่ากันในแต่ละภูมิภาค นอกจากนี้ คุณควรจะได้รับการตอบกลับจาก API ที่มีโครงร่างอาคาร แต่ไม่มีการเข้า คาดว่าการครอบคลุมทางเข้าจะดีขึ้นเมื่อเวลาผ่านไป

ความคิดเห็น

นี่เป็นฟีเจอร์ทดลองใช้ เรายินดีรับฟังความคิดเห็นจากคุณที่ buildings-in-geocoding-feedback-channel@google.com