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