Terreni

Sviluppatori dello Spazio economico europeo (SEE)

Il campo grounds all'interno della risposta di geocodifica contiene un singolo motivo che, quando viene compilato, fornisce informazioni contestuali sul territorio immediato in cui si trova la geocodifica. Ad esempio:

  • Se il geocodice è un museo situato all'interno di un parco, il terreno potrebbe essere il parco.
  • Se il geocodice è un negozio all'interno di un centro commerciale, il terreno potrebbe essere il centro commerciale.
  • Se il geocodice è di un ristorante all'interno di un complesso sportivo, il terreno potrebbe essere il complesso sportivo.
  • Se il geocodice è un edificio all'interno di un'università, il terreno potrebbe essere l'università.
  • Se il geocodice è un edificio per uffici all'interno di un campus aziendale, il terreno potrebbe essere il campus aziendale.

Il motivo contiene i seguenti valori:

  • outline contiene la codifica GeoJSON del poligono che approssima la superficie terrestre coperta dal terreno, utilizzando il formato RFC 7946
  • name contiene il nome del motivo ed è un oggetto con i campi secondari language_code e text

I motivi vengono restituiti per alcuni, ma non per tutti, i luoghi con una posizione esatta, come indirizzi stradali, edifici e attività. I luoghi che rappresentano grandi aree, come città e regioni, non verranno restituiti con i terreni.

Dettagli della richiesta

Puoi ottenere punti di navigazione nei seguenti tipi di richieste:

Per una qualsiasi di queste richieste, devi fornire questo parametro: extra_computations=GROUNDS.

Esempio di richiesta

La seguente query utilizza il geocoding del luogo per ottenere il terreno di un ristorante all'interno di un centro commerciale a Hackensack, New Jersey, Stati Uniti:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ-Wdg_3b6wokRjB1ux1e68XM&extra_computations=GROUNDS&key=YOUR_API_KEY

Esempio di risposta

La risposta alla query precedente mostra i motivi:

{
  "grounds" : {
    "display_name" : {
      "language_code" : "en",
      "text" : "The Shops at Riverside"
    },
    "outline" : {
      "coordinates" : [
        [
          [
            -74.03276087437951,
            40.9079393287367
          ],
          [
            -74.0328096444231,
            40.9079123990298
          ],
          [
            -74.032853573312,
            40.9078787684781
          ],
          [
            -74.0329374864265,
            40.907833205165
          ],
          [
            -74.0329543407656,
            40.9076763372261
          ],
          [
            -74.0329762155439,
            40.9076367262102
          ],
          [
            -74.03299916612821,
            40.9075190685498
          ],
          [
            -74.0330511635356,
            40.9071219006983
          ],
          [
            -74.0331433244228,
            40.9065102533867
          ],
          [
            -74.03309025123249,
            40.906473864115
          ],
          [
            -74.0330778794394,
            40.9064567729216
          ],
          [
            -74.03304363287749,
            40.9063779338105
          ],
          [
            -74.03298374620459,
            40.9062267374933
          ],
          [
            -74.03284191870981,
            40.9060418308559
          ],
          [
            -74.0327045736519,
            40.9058626714851
          ],
          [
            -74.0324668194403,
            40.9055539457374
          ],
          [
            -74.03218782543171,
            40.9051507995429
          ],
          [
            -74.03202878431971,
            40.9049213427489
          ],
          [
            -74.031980910588,
            40.9048524525955
          ],
          [
            -74.0318966384468,
            40.9047239669456
          ],
          [
            -74.03188946634801,
            40.9047059572771
          ],
          [
            -74.0318858802984,
            40.904689357769
          ],
          [
            -74.03188605960089,
            40.9046316335439
          ],
          [
            -74.0317557066551,
            40.9044960202159
          ],
          [
            -74.03166641393911,
            40.9044030668361
          ],
          [
            -74.031603120081,
            40.9043369552179
          ],
          [
            -74.0315466397082,
            40.9042767712891
          ],
          [
            -74.03149625561549,
            40.9042231654583
          ],
          [
            -74.0314272240077,
            40.9041493230684
          ],
          [
            -74.0313515581648,
            40.9040692773688
          ],
          [
            -74.031280374868,
            40.9039955812079
          ],
          [
            -74.0312140327287,
            40.9040621334267
          ],
          [
            -74.03094346414279,
            40.9042364679492
          ],
          [
            -74.0309237407716,
            40.9042490145166
          ],
          [
            -74.0309043760051,
            40.9042578521067
          ],
          [
            -74.0308932591939,
            40.9042613909983
          ],
          [
            -74.0308821423819,
            40.9042634259862
          ],
          [
            -74.0308654671629,
            40.9042639218323
          ],
          [
            -74.0285474182009,
            40.9040980324443
          ],
          [
            -74.0285409631984,
            40.9041506567763
          ],
          [
            -74.0284695995455,
            40.9041477672732
          ],
          [
            -74.0284391175751,
            40.904464680407
          ],
          [
            -74.0284416278552,
            40.9044690964629
          ],
          [
            -74.0284448553581,
            40.9044713582818
          ],
          [
            -74.0284504138353,
            40.9044724463848
          ],
          [
            -74.0284848405289,
            40.9044735630073
          ],
          [
            -74.02849255067299,
            40.9047420452213
          ],
          [
            -74.0285024124847,
            40.9047613382318
          ],
          [
            -74.0285088674885,
            40.9047682680531
          ],
          [
            -74.0285178327711,
            40.9047717937456
          ],
          [
            -74.02860246501849,
            40.9047800216474
          ],
          [
            -74.0284446760524,
            40.9060030191662
          ],
          [
            -74.02847533732761,
            40.9060129264131
          ],
          [
            -74.0288760851204,
            40.9060525457656
          ],
          [
            -74.0285884791836,
            40.9069432827033
          ],
          [
            -74.02962647637111,
            40.9069961651161
          ],
          [
            -74.029634186469,
            40.906997858665
          ],
          [
            -74.0296395656068,
            40.9070004251279
          ],
          [
            -74.0296417172619,
            40.9070019329367
          ],
          [
            -74.02964422752621,
            40.907003491537
          ],
          [
            -74.02964691709499,
            40.9070070305046
          ],
          [
            -74.02964763431331,
            40.907010440501
          ],
          [
            -74.02964727570421,
            40.9070133973578
          ],
          [
            -74.02964619987669,
            40.9070203129561
          ],
          [
            -74.02999046437181,
            40.9070453118125
          ],
          [
            -74.03005788276261,
            40.9077398485747
          ],
          [
            -74.0300808336987,
            40.9080079189719
          ],
          [
            -74.03036987181341,
            40.9080202832536
          ],
          [
            -74.03096784939891,
            40.9080511362848
          ],
          [
            -74.03120058499491,
            40.9080502612003
          ],
          [
            -74.0314021215987,
            40.9080639151613
          ],
          [
            -74.03163754620471,
            40.9080799617702
          ],
          [
            -74.03186472260489,
            40.9080952909298
          ],
          [
            -74.0319188719515,
            40.9080990493699
          ],
          [
            -74.0320239431563,
            40.9080594910787
          ],
          [
            -74.0324187665168,
            40.9080114893404
          ],
          [
            -74.0325363885767,
            40.907988144292
          ],
          [
            -74.0326864641787,
            40.9079585672777
          ],
          [
            -74.03276087437951,
            40.9079393287367
          ]
        ]
      ],
      "type" : "Polygon"
    }
  },
}

Utilizzando il codice JavaScript simile all'esempio in Contorni e ingressi degli edifici, possiamo eseguire il rendering del contorno del terreno sulla mappa:

Contorno del terreno visualizzato sulla mappa

Feedback

Questa è una funzione sperimentale. Apprezziamo il tuo feedback all'indirizzo geocoding-feedback-channel@google.com.