Đường viền toà nhà và lối vào

Đường viền của toà nhà là một tập hợp các cặp toạ độ vĩ độ/kinh độ xác định một đa giác 2D thể hiện diện tích bề mặt của trái đất mà toà nhà che phủ. Bạn có thể sử dụng đa giác này để vẽ đường viền của một toà nhà trên bản đồ. Lối vào là cặp toạ độ vĩ độ/kinh độ duy nhất xác định vị trí của một điểm ra vào vào một địa điểm; ví dụ, cửa của một tòa nhà.

Các tham số bổ sung

Thêm extra_computations=BUILDING_AND_ENTRANCES vào yêu cầu mã hoá địa lý, yêu cầu mã hoá địa lý ngược hoặc yêu cầu mã hoá địa lý địa điểm để nhận thông tin về lối vào và đường viền của toà nhà trong phản hồi.

Yêu cầu mẫu

Truy vấn sau đây cho phép hình dáng toà nhà và lối vào của một nhà hàng tại Mountain View, California, Hoa Kỳ:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY

Ví dụ về phản hồi

Phản hồi từ truy vấn ở trên như sau:

{
  "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"
    }
  ],
}

Có 2 mảng có thể được trả về khi bật tính năng này: buildings[]entrances[].

Mỗi kết quả entrances có các trường sau:

  • location là vĩ độ/kinh độ của lối vào.
  • building_place_id là mã địa điểm của toà nhà có chứa lối vào. Xin lưu ý rằng tham số này không phải lúc nào cũng được điền sẵn.

Mỗi kết quả buildings đều có các trường sau:

  • place_id là giá trị nhận dạng duy nhất của toà nhà. Xem tổng quan về mã địa điểm để biết thêm chi tiết.
  • building_outlines[] là một mảng các đường viền được liên kết với toà nhà. Hiện tại, mảng này sẽ chỉ có một mục nhập. Mỗi đối tượng trong building_outlines[] có các trường sau đây:
    • display_polygon là mã hoá GeoJSON của đa giác gần đúng với diện tích bề mặt của trái đất mà toà nhà bao phủ, sử dụng định dạng RFC 7946. Xin lưu ý rằng định dạng RFC 7946 hỗ trợ nhiều đa giác, vì vậy, một đối tượng display_polygon có thể đại diện cho nhiều đa giác.

Phạm vi tổng hợp dữ liệu

Tính năng này có ở tất cả các khu vực; tuy nhiên, không phải tất cả các toà nhà đều sẽ có đường viền hoặc lối vào và phạm vi bao phủ sẽ thay đổi theo khu vực. Ngoài ra, bạn sẽ nhận được các phản hồi API chứa đường viền của toà nhà nhưng không có lối vào. Mức độ phù hợp về lối vào dự kiến sẽ cải thiện theo thời gian.

Phản hồi

Đây là tính năng thử nghiệm. Chúng tôi rất mong nhận được ý kiến phản hồi tại buildings-in-geocoding-feedback-channel@google.com.