Contorno y entradas de los edificios

El contorno de un edificio es un conjunto de pares de coordenadas de latitud y longitud que definen un polígono 2D que representa el área de la superficie de la Tierra que cubre 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 habilita los contornos y las entradas de 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 son 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 detalles.
  • building_outlines[] es un array de esquemas asociados con el edificio. A partir de ahora, 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 varios polí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 contornos ni 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.