Profilo ed ingressi degli edifici

Il profilo di un edificio è un insieme di coppie di coordinate di latitudine/longitudine che definiscono un poligono 2D che rappresenta la superficie della terra coperta dall'edificio. Puoi utilizzare 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, una richiesta di geocodifica inversa o una richiesta di geocodifica dei luoghi per ricevere ingressi e contorni degli edifici nella risposta.

Esempio di richiesta

La seguente query consente di visualizzare i contorni e gli ingressi di un ristorante a Mountain View, in 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 entrances contiene i seguenti campi:

• location sono 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. Per ulteriori dettagli, consulta la panoramica degli ID luogo.
• building_outlines[] è un array di contorni associati a dell'edificio. Al momento questo array avrà una sola voce. Ogni oggetto in building_outlines[] ha 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 oggetto display_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 aspettarti di ricevere risposte dell'API che contengono il profilo di un edificio, ma nessuna entrata. 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.