بلاط التضاريس

نظرة عامة على مربّعات التضاريسمربّعات التضاريس هي مربّعات صور تحتوي على خطوط ظلال التلال والخطوط الكنتورية. وتشمل هذه العناصر العناصر الطبيعية، مثل النباتات.

الحصول على مربّعات التضاريس

يمكنك بدء تقديم طلبات لشراء شرائح تضاريس بعد الحصول على رمز مميّز للجلسة. بما أنّ رمز الجلسة ينطبق على الجلسة بأكملها، ليس عليك تحديد خيارات الخريطة مع طلبات المربّعات.

يوضّح نموذج الرمز البرمجي التالي طلبًا نموذجيًا لرمز تعريف الجلسة للوحات التضاريس.

curl -X POST -d '{
  "mapType": "terrain",
  "language": "en-US",
  "region": "US",
  "layerTypes": ["layerRoadmap"]
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

يمكنك الحصول على شرائح التضاريس من خلال تقديم طلب HTTPS GET، كما هو موضّح في المثال التالي.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY

مثال على طلب مربّع

راجِع المثال التالي الذي يطلب مربّعًا واحدًا من تضاريس سطح الأرض بمستوى التكبير 10، مع إحداثيات x وy‏ (192، 401).

curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

لا تتوفّر رسالة استجابة من الخادم في هذا المثال. بدلاً من ذلك، يتم تنزيل المربّع فقط إلى ملف على الجهاز.

استجابة تنزيل بلاط التضاريس

للحصول على معلومات عن رؤوس رسائل الاستجابة، يُرجى الاطّلاع على مقالة الاسترجاع المُسبَق أو التخزين المؤقت أو تخزين المحتوى.