Контур здания — это набор пар координат широты и долготы, которые определяют двумерный многоугольник, представляющий площадь поверхности земли, покрытую зданием. Вы можете использовать этот многоугольник, чтобы нарисовать контур здания на карте. Вход — это одна пара координат широты и долготы, которая определяет местоположение точки входа и выхода в определенное место; например, дверь здания.
Дополнительные параметры
Включите 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
— это идентификатор места здания, в котором находится вход. Обратите внимание, что этот параметр не всегда будет заполняться.
Результат каждого buildings
имеет следующие поля:
-
place_id
— уникальный идентификатор здания. Более подробную информацию можно найти в обзоре идентификаторов мест . -
building_outlines[]
— массив контуров, связанных со зданием. На данный момент в этом массиве будет только одна запись. Каждый объект вbuilding_outlines[]
имеет следующие поля: -
display_polygon
— это кодировка GeoJSON многоугольника, который приблизительно соответствует площади поверхности земли, покрытой зданием, в формате RFC 7946 . Обратите внимание, что формат RFC 7946 поддерживает несколько полигонов, поэтому один объектdisplay_polygon
может представлять несколько полигонов.
Покрытие
Эта функция доступна во всех регионах; однако не все здания будут иметь очертания или входы.
Обратная связь
Это экспериментальная функция. Мы будем признательны за обратную связь по адресу Building-in-geocoding-feedback-channel@google.com .