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 debuilding_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 objetodisplay_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.