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

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

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