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

تقدّم نقطة نهاية 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

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