توفِّر نقطة النهاية 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
إلى جانب إحداثيات كل مربّع:
راجع إحداثيات الخريطة والمربّع للحصول على تفاصيل إضافية.
لمحة عن نقطة نهاية خريطة التمثيل اللوني
يتم تمثيل مربّع خريطة التمثيل اللوني بمصفوفة بايت تحتوي على بيانات المربّعات كصورة 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
يظهر المربّع على النحو التالي:
للحصول على مزيد من المعلومات حول تراكب المربعات أعلى الخريطة الافتراضية، راجع أنواع خرائط التراكب.