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

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

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