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

تشير رسالة الأشكال البيانية 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

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