مربّعات خرائط الطريق

المطوّرون في المنطقة الاقتصادية الأوروبية

نظرة عامة على شاشة معلومات "خريطة الطريق"مربّعات خريطة الطريق هي مربّعات صور تستند إلى بيانات طبوغرافية متجهة مع تصميم رسم الخرائط من Google. ويشمل ذلك الطرق والمباني والمعالم والحدود السياسية.

الحصول على مربّعات خارطة الطريق

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

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

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

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

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

في طلب استرداد البيانات باستخدام HTTPS GET هذا، يمثّل z مستوى التكبير/التصغير (يتراوح بين 0 و22)، ويمثّل x وy إحداثيات المربّع الذي تريد استرداده.

مَعلمة orientation اختيارية. تحدّد قيمتها عدد درجات دوران صورة المربّع عكس عقارب الساعة. تتوفّر ميزة orientation لمربّعات roadmap، كما تتوفّر لطلبات صور القمر الصناعي والتضاريس مع إزالة الصور الأساسية باستخدام "overlay": true، ومع ضبط layerTypes. القيم الصالحة لـ orientation هي 0 (القيمة التلقائية) و90 و180 و270.

لا يتم تدوير شبكة إحداثيات المربّعات إذا أدرجت قيمة orientation. على سبيل المثال، إذا ضبطت orientation على 90، سيظل الإحداثي x يحدّد موضع المربّع من اليسار إلى اليمين، والذي يكون في هذه الحالة من الشمال إلى الجنوب على الخريطة.

الاتجاه بزاوية صفر درجة الاتجاه بزاوية 90 درجة
الاتجاه بزاوية صفر درجة الاتجاه بزاوية 90 درجة

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

لنأخذ المثال التالي الذي يطلب مربّعًا واحدًا يحتوي على العالم بأسره. في هذا المثال، مستوى التكبير هو 0، والإحداثيان x وy هما 0 و0.

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

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

العالم بأسره في مربّع واحد

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

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