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

Sản phẩm hoặc tính năng này đang ở giai đoạn thử nghiệm (trước giai đoạn phát hành rộng rãi). Những sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể được hỗ trợ hạn chế, đồng thời có những thay đổi đối với các sản phẩm trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi. Sản phẩm trước giai đoạn phát hành rộng rãi được hỗ trợ bởi Google Điều khoản dành riêng cho dịch vụ của Nền tảng Maps. Để biết thêm thông tin, hãy xem nội dung mô tả các giai đoạn chạy chiến dịch.

Đường viền toà nhà là một tập hợp cặp toạ độ vĩ độ/kinh độ xác định Đa giác 2D thể hiện diện tích bề mặt trái đất được toà nhà bao phủ. Bạn có thể sử dụng đa giác này để vẽ đường viền của một tòa 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

Bao gồm extra_computations=BUILDING_AND_ENTRANCES trong yêu cầu mã hoá địa lý, yêu cầu mã hoá địa lý đảo ngược, hoặc yêu cầu mã hoá địa lý địa điểm để nhận lối vào và đường viền toà nhà trong câu trả lời của bạn.

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 của 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[] và entrances[].

Mỗi kết quả entrances đều 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 không phải lúc nào thông số này cũng được điề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 ước chừng diện tích bề mặt trái đất được bao phủ bởi toà nhà, sử dụng Định dạng RFC 7946. Lưu ý rằng định dạng RFC 7946 hỗ trợ đa đa giác, vì vậy, một đối tượng display_polygon có thể biểu thị 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.

Phản hồi

Đây là tính năng thử nghiệm. Chúng tôi mong nhận được ý kiến phản hồi tại [e-mail].