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

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

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