園區

歐洲經濟區 (EEA) 開發人員

地理編碼回應中的 grounds 欄位包含單一依據,填入後,即可提供地理編碼所在的直接區域的背景資訊。例如:

  • 如果地理編碼是位於公園內的博物館,地面可能就是公園。
  • 如果地理編碼是小型商場內的商店,地點可能就是小型商場。
  • 如果地理編碼是位於體育中心內的餐廳,地點可能就是體育中心。
  • 如果地理編碼是大學內的建築物,地點可能就是該大學。
  • 如果地理編碼是企業園區內的辦公大樓,地點可能就是企業園區。

理由包含下列值:

  • outline 包含多邊形的 GeoJSON 編碼,該編碼會使用 RFC 7946 格式,近似地表示地面覆蓋範圍
  • name 包含地點名稱,且為包含子欄位 language_codetext 的物件

系統會針對部分精確位置 (例如街道地址、建築物和機構) 傳回地點依據,但並非所有精確位置都會傳回。代表大範圍區域的地點 (例如城市和區域) 不會連同地面傳回。

要求詳細資料

您可以在下列類型的要求中取得導覽點:

針對任何這類要求,您都必須提供以下參數:extra_computations=GROUNDS

要求範例

以下查詢使用地點地理編碼功能,取得位於美國新澤西州哈肯薩克 (Hackensack) 購物中心內的餐廳地點:

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

回應範例

上述查詢的回應會顯示理由:

{
  "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"
    }
  },
}

使用類似「建築物輪廓和入口」一節中範例的 JavaScript 程式碼,我們就能在地圖上算繪場地輪廓:

在地圖上顯示的場地輪廓

意見回饋

這項功能仍在實驗階段,歡迎透過 geocoding-feedback-channel@google.com 與我們聯絡,提供寶貴意見。