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

توفّر نقطة نهاية 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.

للحصول على مزيد من المعلومات حول تراكب المربعات في أعلى الخريطة الافتراضية، راجع أنواع الخرائط التي تظهر على سطح الفيديو.