건물 외곽선 및 입구

건물 윤곽선은 건물로 덮인 지구의 표면적을 나타내는 2D 다각형을 정의하는 위도/경도 좌표 쌍 집합입니다. 이 다각형을 사용하여 지도에 건물의 윤곽선을 그릴 수 있습니다. 입구는 장소의 진입점과 출입점의 위치를 정의하는 단일 위도/경도 좌표 쌍입니다(예: 건물의 문).

추가 매개변수

지오코딩 요청, 역지오코딩 요청 또는 장소 지오코딩 요청에 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는 입구가 있는 건물의 장소 ID입니다. 이 매개변수는 항상 채워지는 것은 아닙니다.

각 buildings 결과에는 다음과 같은 필드가 있습니다.

  • place_id는 건물의 고유 식별자입니다. 자세한 내용은 장소 ID 개요를 참고하세요.
  • building_outlines[]는 건물과 연결된 윤곽선 배열입니다. 현재 이 배열에는 항목이 하나만 있습니다. building_outlines[]의 각 객체에는 다음 필드가 있습니다.
    • display_polygon는 RFC 7946 형식을 사용하여 건물이 덮는 지구의 표면적을 근사하는 다각형의 GeoJSON 인코딩입니다. RFC 7946 형식은 다중 다각형을 지원하므로 하나의 display_polygon 객체가 여러 다각형을 나타낼 수 있습니다.

적용 범위

이 기능은 모든 지역에서 사용할 수 있습니다. 하지만 모든 건물에 윤곽선이나 입구가 있는 것은 아니며, 적용 범위는 지역에 따라 다릅니다. 또한 건물 개요는 포함되어 있지만 출입구는 없는 API 응답을 받게 됩니다. 시간이 지남에 따라 진입 노출 범위가 개선될 것으로 예상됩니다.

의견

실험용으로 제공되는 기능입니다. buildings-in-geocoding-feedback-channel@google.com으로 의견을 보내주세요.