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

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

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