השדה grounds בתגובה של הקידוד הגיאוגרפי מכיל ערך יחיד של grounds. כשהשדה הזה מאוכלס, הוא מספק מידע הקשרי על השטח המיידי שבו מתבצע הקידוד הגיאוגרפי. לדוגמה:
- אם הקואורדינטות הן של מוזיאון שנמצא בתוך פארק, יכול להיות שהשטח הוא הפארק.
- אם הקידוד הגיאוגרפי הוא של חנות בקניון, יכול להיות שהשטח הוא הקניון.
- אם הקואורדינטות הן של מסעדה בתוך מתחם ספורט, יכול להיות שהשטח יהיה מתחם הספורט.
- אם הקואורדינטות הן של בניין בתוך אוניברסיטה, יכול להיות שהשטח הוא האוניברסיטה.
- אם הקואורדינטות הן של בניין משרדים בקמפוס של חברה, יכול להיות שהשטח יהיה הקמפוס של החברה.
השדה grounds מכיל את הערכים הבאים:
-
outlineמכיל את קידוד ה-GeoJSON של הפוליגון שמייצג בקירוב את שטח פני כדור הארץ שכלול בשטח, בפורמט RFC 7946 -
nameמכיל את שם העילה והוא אובייקט עם שדות משנהlanguage_codeו-text
השדה grounds מוחזר עבור חלק מהמקומות עם מיקום מדויק, כמו כתובות, בניינים ומוסדות, אבל לא עבור כולם. מקומות שמייצגים אזורים גדולים, כמו ערים ואזורים, לא יוחזרו עם נתונים על השטח.
פרטי הבקשה
אפשר לקבל נקודות ניווט בסוגים הבאים של בקשות:
- בקשה להמרת כתובות לקואורדינטות
- בקשה להמרת קואורדינטות לכתובות (reverse geocoding)
- בקשה להמרת כתובות של מקומות לקואורדינטות (geocoding)
בכל אחת מהבקשות האלה, צריך לספק את הפרמטר הבא:
extra_computations=GROUNDS.
דוגמה לבקשה
השאילתה הבאה משתמשת בהמרת כתובות לקואורדינטות (geocoding) של מקום כדי לקבל את השטח של מסעדה בקניון בהאקנסאק, ניו ג'רזי, ארצות הברית:
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.