يحتوي الحقل grounds ضمن ردّ الترميز الجغرافي على أرض واحدة، وعند ملء هذا الحقل، يقدّم معلومات سياقية حول المنطقة المجاورة التي يقع فيها الترميز الجغرافي. على سبيل المثال:
- إذا كان الرمز الجغرافي يخص متحفًا يقع داخل حديقة، قد تكون الأرض هي الحديقة.
- إذا كان الرمز الجغرافي يخص متجرًا داخل قطاع مركز تجاري، قد تكون الأراضي هي قطاع المركز التجاري.
- إذا كان الرمز الجغرافي يخصّ مطعمًا داخل مجمّع رياضي، قد تكون الأراضي هي المجمّع الرياضي.
- إذا كان الرمز الجغرافي يخص مبنى داخل جامعة، قد تكون الأرض هي الجامعة.
- إذا كان الرمز الجغرافي عبارة عن مبنى مكاتب داخل حرم جامعي للشركة، فقد تكون الأرض هي الحرم الجامعي للشركة.
تتضمّن الأسباب القيم التالية:
- يحتوي
outlineعلى ترميز GeoJSON الخاص بالمضلّع الذي يقرّب مساحة سطح الأرض التي تغطيها الأراضي، وذلك باستخدام تنسيق RFC 7946 - يحتوي
nameعلى اسم الأسباب وهو عنصر يتضمّن الحقلَين الفرعيَينlanguage_codeوtext
يتم إرجاع الأسباب لبعض الأماكن، ولكن ليس كلها، مع موقع محدد، مثل عناوين الشوارع والمباني والمؤسسات. لن يتم عرض الأراضي مع الأماكن التي تمثّل مساحات كبيرة، مثل المدن والمناطق.
تفاصيل الطلب
يمكنك الحصول على نقاط التنقّل في أنواع الطلبات التالية:
بالنسبة إلى أي من هذه الطلبات، يجب تقديم المَعلمة التالية:
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.