건물 외곽선 및 입구

건물 외곽선은 건물의 위치를 정의하는 위도/경도 좌표 쌍 집합입니다. 건물로 덮인 지구의 표면적을 나타내는 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[]는 다음과 관련된 윤곽선의 배열입니다. 있습니다. 현재 이 배열에는 항목이 하나만 있습니다. Kubernetes의 building_outlines[]에는 다음과 같은 필드가 있습니다.
• display_polygon는 다각형의 GeoJSON 인코딩입니다. 건물을 덮는 지구의 표면적에 근접합니다. RFC 7946 형식 RFC 7946 형식은 다중 다각형, 하나의 display_polygon 객체가 여러 다각형을 나타낼 수 있습니다.

적용 범위

이 기능은 모든 리전에서 사용할 수 있습니다. 하지만 모든 건물에 경계선이나 입구가 포함되어 있습니다.

의견

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