Il profilo di un edificio è un insieme di coppie di coordinate latitudine/longitudine che definiscono Poligono 2D che rappresenta l'area della superficie terrestre coperta dall'edificio. Puoi usare questo poligono per tracciare il contorno di un edificio su una mappa. Un'entrata è una singola coppia di coordinate di latitudine/longitudine che definisce posizione di un punto di ingresso e di uscita in un luogo; ad esempio, la porta di una edifici.
Parametri aggiuntivi
Includi
extra_computations=BUILDING_AND_ENTRANCES
in una richiesta di geocodifica,
richiesta di geocodifica inversa,
o una richiesta di geocodifica di luoghi
per ricevere entrate e contorni degli edifici nella tua risposta.
Esempio di richiesta
La seguente query consente i profili e gli ingressi di un edificio per un ristorante in Mountain View, California, Stati Uniti:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY
Esempio di risposta
La risposta alla query precedente è la seguente:
{
"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"
}
],
}
Quando questa funzionalità è abilitata, è possibile restituire due array:
buildings[]
e entrances[]
.
Ogni risultato di entrances
ha i seguenti campi:
location
indica le coordinate di latitudine/longitudine dell'ingresso.building_place_id
è l'ID luogo dell'edificio che contiene l'ingresso. Tieni presente che questo parametro non verrà sempre compilato.
Ogni risultato di buildings
ha i seguenti campi:
place_id
è l'identificatore univoco dell'edificio. Consulta le panoramica ID luogo per ulteriori dettagli.building_outlines[]
è un array di contorni associati a dell'edificio. Al momento questo array ha una sola voce. Ogni oggetto inbuilding_outlines[]
contiene i seguenti campi:display_polygon
è la codifica GeoJSON del poligono che si avvicina alla superficie terrestre coperta dall'edificio, utilizzando formato RFC 7946. Tieni presente che il formato RFC 7946 supporta i poligoni multipli, quindi un oggettodisplay_polygon
può rappresentare più poligoni.
Copertura
Questa funzionalità è disponibile in tutte le regioni. tuttavia non tutti gli edifici avranno profili o ingressi e la copertura varierà in base alla regione. Inoltre, dovresti si aspettano di ricevere risposte dell'API che contengono il contorno di un edificio, ma entrate. Si prevede che la copertura delle entrate migliorerà nel tempo.
Feedback
Questa è una funzione sperimentale. Vorremmo ricevere un feedback all'indirizzo buildings-in-geocoding-feedback-channel@google.com.