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

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

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