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

Этот продукт или функция являются экспериментальными (до GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и ​​функциях Pre-GA могут быть несовместимы с другими версиями Pre-GA. На предложения Pre-GA распространяются Особые условия обслуживания платформы Google Maps . Дополнительную информацию см. в описании этапов запуска .

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

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

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

Покрытие

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

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

Это экспериментальная функция. Мы будем признательны за обратную связь по адресу [e-mail] .