건물 외곽선 및 입구

건물 외곽선은 건물의 위치를 정의하는 위도/경도 좌표 쌍 집합입니다. 건물로 덮인 지구의 표면적을 나타내는 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"
    }
  ],
}

이 기능을 사용 설정하면 다음 2개의 배열이 반환될 수 있습니다. 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으로 의견을 보내 주세요.