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

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

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