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 la 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 singolo oggettodisplay_polygon
può rappresentare più poligoni.
Copertura
Questa funzionalità è disponibile in tutte le regioni. tuttavia non tutti gli edifici avranno profili o entrate.
Feedback
Questa è una funzione sperimentale. Vorremmo ricevere un feedback all'indirizzo buildings-in-geocoding-feedback-channel@google.com.