שטחי האחוזה

מפתחים באזור הכלכלי האירופי (EEA)

השדה grounds בתגובה של הקידוד הגיאוגרפי מכיל ערך יחיד של grounds. כשהשדה הזה מאוכלס, הוא מספק מידע הקשרי על השטח המיידי שבו מתבצע הקידוד הגיאוגרפי. לדוגמה:

  • אם הקואורדינטות הן של מוזיאון שנמצא בתוך פארק, יכול להיות שהשטח הוא הפארק.
  • אם הקידוד הגיאוגרפי הוא של חנות בקניון, יכול להיות שהשטח הוא הקניון.
  • אם הקואורדינטות הן של מסעדה בתוך מתחם ספורט, יכול להיות שהשטח יהיה מתחם הספורט.
  • אם הקואורדינטות הן של בניין בתוך אוניברסיטה, יכול להיות שהשטח הוא האוניברסיטה.
  • אם הקואורדינטות הן של בניין משרדים בקמפוס של חברה, יכול להיות שהשטח יהיה הקמפוס של החברה.

השדה grounds מכיל את הערכים הבאים:

  • outline מכיל את קידוד ה-GeoJSON של הפוליגון שמייצג בקירוב את שטח פני כדור הארץ שכלול בשטח, בפורמט RFC 7946
  • name מכיל את שם העילה והוא אובייקט עם שדות משנה language_code ו-text

השדה grounds מוחזר עבור חלק מהמקומות עם מיקום מדויק, כמו כתובות, בניינים ומוסדות, אבל לא עבור כולם. מקומות שמייצגים אזורים גדולים, כמו ערים ואזורים, לא יוחזרו עם נתונים על השטח.

פרטי הבקשה

אפשר לקבל נקודות ניווט בסוגים הבאים של בקשות:

בכל אחת מהבקשות האלה, צריך לספק את הפרמטר הבא: 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.