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