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