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

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

ملاحظة: لا تتطابق إحداثيات المربّعات مع الإحداثيات الجغرافية. لمزيد من المعلومات عن إحداثيات المربّعات، اطّلِع على إحداثيات الخريطة والمربّعات في مستندات واجهة برمجة تطبيقات JavaScript لـ "خرائط Google".

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

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

الاتجاه بدرجة صفرية	الاتجاه بزاوية 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

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