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

تقدّم نقطة النهاية 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 من خلال إرسال طلب GET HTTP إلى:

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

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