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

نظرة عامة على مربّع "خارطة الطريق"تشكّل مربّعات الخريطة المخطّط وحدات صور تستند إلى بيانات طبوغرافية متجه مع تنسيق رسم الخرائط من 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"

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

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

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