مربعات خريطة الطريق هي مربّعات صور تستند إلى البيانات الطبوغرافية المتجهة
من خلال تصميم خرائط 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، كما هو موضّح في ما يلي مثال.
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 درجة |
|---|---|
 |
 |
مثال على طلب مربّع
راجِع المثال التالي الذي يطلب مربّعًا واحدًا يحتوي على العالم بأكمله. في هذا المثال، يكون مستوى التكبير/التصغير هو 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
للحصول على معلومات حول رؤوس رسائل الرد، يمكنك الاطّلاع على جلب المحتوى مسبقًا أو تخزينه مؤقتًا أو تخزينه: