Profilo ed ingressi degli edifici

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 in building_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 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 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.