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

ขอบอาคารคือชุดคู่พิกัดละติจูด/ลองจิจูดที่กําหนดรูปหลายเหลี่ยม 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 รายการเดียวจึงแสดงรูปหลายเหลี่ยมได้หลายรูป

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

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

ความคิดเห็น

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