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

توفر نقطة النهاية heatmapTiles خرائط حرارية مرتبطة بحبوب اللقاح من خلال تراكب المربعات. تراكب المربّعات هو مجموعة من مربّعات الصور التي يمكن عرضها فوق "خرائط Google". يبلغ حجم كل مربّع صورة 256 × 256 بكسل.

تراكب المربّعات هو شبكة مجمّعة من مجموعة مربّعات، تم تعيين إحداثيات (X,Y) لكل منها. يكون المربّع الذي يحمل الإحداثيات (0,0) دائمًا في الزاوية الشمالية الغربية من الخريطة. تزداد قيم X من الغرب إلى الشرق، بينما تزداد قيم Y من الشمال إلى الجنوب.

يحدّد zoom level مدى ظهور محتويات الخريطة كبيرة أو صغيرة في طريقة عرض الخريطة. يتم تحديد حجم شبكة المربّعات من خلال توسيع الإحداثيات X وY بشكل أُسي حسب مستوى التكبير أو التصغير.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

على سبيل المثال، عند مستوى تكبير أو تصغير يبلغ 2، يتم تمثيل خريطة العالم باستخدام مصفوفة 4 × 4، بإجمالي 16 مربّعًا.

تعرض الصورة التالية خريطة التمثيل اللوني TREE_UPI للعالم بأكمله، مقسّمة إلى مربعات يمكن الوصول إليها عند مستوى التكبير يبلغ 2.

خريطة التمثيل اللوني للعالم بأكمله على شكل شبكة من 4 صفوف و4 أعمدة

يمكنك الاطّلاع على إحداثيات الخريطة والمربّعات لمزيد من التفاصيل.

يمكنك طلب مربّعات الخريطة الحرارية الحالية لحبوب اللقاح باستخدام نقطة النهاية heatmapTiles من خلال إرسال طلب HTTP GET إلى:

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

لمحة عن نقطة نهاية الخريطة الحرارية

جميع المعلّمات المدرَجة أدناه مطلوبة لإنجاح الطلب:

  • KEY: مفتاح واجهة برمجة التطبيقات لتطبيقك. يحدّد هذا المفتاح تطبيقك لأغراض إدارة الحصص. تعرف على كيفية الحصول على مفتاح
  • TYPE: نوع الخريطة الحرارية المطلوب عرضها. القيم المسموح بها
  • Z: مستوى التكبير أو التصغير الذي يحدّد مدى ظهور محتويات الخريطة كبيرة أو صغيرة في طريقة عرض الخريطة. القيم المسموح بها هي من 0 إلى 16، حيث تعرض القيمة 0 العالم بأكمله في مربّع واحد.
  • X,Y: إحداثيات المربّع بالنسبة إلى الزاوية الشمالية الشرقية (0,0). تزداد قيم X من الغرب إلى الشرق، بينما تزداد قيم Y من الشمال إلى الجنوب. يجب أن تكون الإحداثيات صالحة لمستوى التكبير أو التصغير المحدّد. على سبيل المثال، إذا ضبطت مستوى التكبير أو التصغير على 2 وطلبت مربّعًا بالإحداثيات (10,10)، ستعرض واجهة برمجة التطبيقات رسالة خطأ.

مثال على طلب خريطة التمثيل اللوني

تعرض الصورة أعلاه خريطة حرارية TREE_UPI بمستوى تكبير أو تصغير يبلغ 2، بالإضافة إلى إحداثيات كل مربّع. يستخدم المثال التالي نقطة النهاية heatmapTiles لطلب المربّع بالإحداثيات (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

يظهر المربّع كصورة يمكن عرضها متراكبة على الخريطة:

مثال على مربّع خريطة التمثيل اللوني باستخدام خريطة TREE_UPI

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