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

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

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