Контуры зданий и входы

Контур здания — это набор пар координат широты и долготы, которые определяют двумерный многоугольник, представляющий площадь поверхности земли, покрытую зданием. Вы можете использовать этот многоугольник, чтобы нарисовать контур здания на карте. Вход — это одна пара координат широты и долготы, которая определяет местоположение точки входа и выхода в определенное место; например, дверь здания.

Дополнительные параметры

Включите 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 может представлять несколько полигонов.

Покрытие

Эта функция доступна во всех регионах; однако не все здания будут иметь очертания или входы, а покрытие будет зависеть от региона. Кроме того, вам следует ожидать получения ответов API, содержащих контур здания, но без входов. Ожидается, что со временем охват входов улучшится.

Обратная связь

Это экспериментальная функция. Мы будем признательны за обратную связь по адресу Building-in-geocoding-feedback-channel@google.com .