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

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

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