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

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

راجع إحداثيات الخريطة والمربّعات للحصول على تفاصيل إضافية.

يمكنك طلب مربّعات خريطة التمثيل اللوني لحبوب اللقاح الحالية باستخدام نقطة نهاية نقطة نهاية التمثيل اللوني عن طريق إرسال طلب 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

للحصول على مزيد من المعلومات حول تراكب المربعات في أعلى الخريطة الافتراضية، راجع أنواع الخرائط التي تظهر على سطح الفيديو.