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

تشير رسالة الأشكال البيانية 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.

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