توفّر نقطة نهاية 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.
راجع إحداثيات الخريطة والمربع للحصول على تفاصيل إضافية.
يمكنك طلب أقسام خريطة التمثيل اللوني الحالية لحبوب اللقاح باستخدام نقطة نهاية 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
يظهر المربّع كصورة يمكن تركيبها على الخريطة:
للحصول على مزيد من المعلومات حول تراكب المربعات أعلى الخريطة الافتراضية، راجع أنواع خرائط التراكب.