خرائط التمثيل اللوني

توفّر نقطة نهاية heatmapTiles خرائط حرارية ذات صلة بجودة الهواء من خلال تراكب مربّعات. التراكب المكوّن من مربّعات هو مجموعة من مربّعات صور بتنسيق PNG يمكن عرضها على سطح "خرائط Google". حجم كل مربّع صورة هو 256 × 256 بكسل.

لمحة عن مربّعات خريطة التمثيل اللوني

تراكب الصور هو شبكة تم تجميعها من مجموعة من الصور، وتتم تعيين إحداثيات (X،Y) لكل منها. يكون المربّع الذي يحتوي على الإحداثيات (0,0) دائمًا في الزاوية الشمالية الغربية من الخريطة. تزداد قيم X من الغرب إلى الشرق، بينما تزداد قيم Y من الشمال إلى الجنوب.

يحدّد zoom level حجم ظهور محتوى الخريطة في عرض الخريطة. يتم تحديد حجم شبكة المربّعات من خلال تكبير الإحداثيَين X وY بشكلٍ أسي حسب مستوى التكبير.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

على سبيل المثال، عند مستوى تكبير 2، يتم تمثيل خريطة العالم باستخدام ماتريكس 4 x 4، بإجمالي 16 مربّعًا. وتحدِّد ميزة التصغير/التكبير أيضًا الحد الأقصى للقيمة المسموحة للإحداثيات.

تعرض الصورة التالية خريطة حرارية US_AQI بمعدّل تكبير 2، بالإضافة إلى إحداثيات كل مربّع:

خريطة حرارية للعالم بأكمله على شكل شبكة 4 × 4

اطّلِع على إحداثيات الخريطة والشريحة لمزيد من التفاصيل.

لمحة عن نقطة نهاية خريطة التمثيل اللوني

يتم تمثيل مربّع خريطة الحرارة من خلال صفيف وحدات بايت يحتوي على بيانات المربّع كصورة PNG. يمكنك طلب مربّعات خريطة الحرارة الحالية لجودة الهواء باستخدام نقطة النهاية heatmapTiles من خلال إرسال طلب HTTP GET إلى:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

تكون جميع مَعلمات الطلب مطلوبة في الطلب:

  • ‫TYPE: نوع خريطة الحرارة المطلوب عرضها. اطّلِع على القيم المسموحة.

  • Z - مستوى التكبير أو التصغير الذي يحدّد حجم محتوى الخريطة في عرض الخريطة تتراوح القيم المسموح بها بين 0 و16، حيث تعرض القيمة 0 العالم بأكمله في مربّع واحد.

  • ‫X,Y - إحداثيات المربّع الذي تريد استرجاعه، بالنسبة إلى الزاوية الشمالية الغربية (0,0). تزداد قيم X من الغرب إلى الشرق، وتزداد قيم Y من الشمال إلى الجنوب.

    يجب أن تكون إحداثيات المربّع صالحة لمستوى التكبير أو التصغير المحدّد. على سبيل المثال، إذا ضبطت مستوى التكبير على 2 وطلبت مربّعًا بخطّي عرض وعمق 10،10، ستعرض واجهة برمجة التطبيقات رسالة خطأ.

  • YOUR_API_KEY - مفتاح واجهة برمجة التطبيقات لتطبيقك. يحدِّد هذا المفتاح تطبيقك لأغراض إدارة الحصة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الحصول على مفتاح.

مثال على طلب خريطة التمثيل اللوني

تعرض الصورة أعلاه خريطة حرارية US_AQI بمعدّل تكبير 2، بالإضافة إلى إحداثيات كل مربّع. يستخدم المثال التالي نقطة نهاية heatmapTiles لطلب المربّع على الإحداثيات 0,1 من الخريطة الحرارية:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

يظهر المربّع على النحو التالي:

مربّع خريطة التمثيل اللوني عند الإحداثيَين 0,1

لمزيد من المعلومات عن تراكب الصور على الخريطة التلقائية، اطّلِع على أنواع الخرائط التي يمكن تراكبها.