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