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

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

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