Contorno y entradas de los edificios

El contorno de un edificio es un conjunto de pares de coordenadas de latitud y longitud que definen una Polígono en 2D que representa el área de la superficie terrestre cubierta por el edificio. Puedes utilizar este polígono para dibujar el contorno de un edificio en un mapa. Una entrada es un único par de coordenadas de latitud y longitud que define la ubicación de un punto de entrada y salida a un lugar; por ejemplo, la puerta de una del edificio.

Parámetros adicionales

Incluir extra_computations=BUILDING_AND_ENTRANCES en una solicitud de geocodificación solicitud de geocodificación inversa, o una solicitud de geocodificación de lugares para recibir entradas y esquemas de edificios en tu respuesta.

Ejemplo de solicitud

La siguiente consulta permite construir contornos y entradas para un restaurante en Mountain View, California, Estados Unidos:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY

Ejemplo de respuesta

La respuesta de la consulta anterior es la siguiente:

{
  "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"
    }
  ],
}

Se pueden mostrar 2 arrays cuando esta función está habilitada: buildings[] y entrances[].

Cada resultado de entrances tiene los siguientes campos:

  • location es las coordenadas de latitud y longitud de la entrada.
  • building_place_id es el ID de lugar del edificio que contiene la entrada. Ten en cuenta que este parámetro no siempre se propagará.

Cada resultado de buildings tiene los siguientes campos:

  • place_id es el identificador único del edificio. Consulta la descripción general de los IDs de lugar para obtener más información.
  • building_outlines[] es un array de esquemas asociados con el edificio. Por el momento, este array solo tendrá una entrada. Cada objeto de building_outlines[] tiene los siguientes campos:
    • display_polygon es la codificación GeoJSON del polígono. que se aproxima a la superficie terrestre cubierta por el edificio, mediante el Formato RFC 7946 Ten en cuenta que el formato RFC 7946 admite multipolígonos, por lo que un objeto display_polygon puede representar varios polígonos.

Cobertura

Esta función está disponible en todas las regiones. Sin embargo, no todos los edificios tendrán indicaciones o entradas, y la cobertura variará según la región. Además, debes esperas recibir respuestas de la API que contengan el esquema de un edificio, pero y otras entradas. Se espera que la cobertura de entradas mejore con el tiempo.

Comentarios

Esta función se encuentra en fase experimental. Nos gustaría recibir comentarios en buildings-in-geocoding-feedback-channel@google.com.