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

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

على سبيل المثال، عند مستوى تكبير/تصغير 2، يتم تمثيل خريطة العالم باستخدام مصفوفة 4 × 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

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