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