الحصول على خرائط الطقس (ميزة تجريبية)

يوفر نقطة النهاية mapTypes مربّعات خرائط نقطية تمثّل الظواهر الجوية المختلفة، مثل توقّعات هطول الأمطار. يمكن عرض مربّعات الخرائط هذه فوق "خرائط Google" العادية.

البنود

يتم إصدار هذه البنود بموجب الفقرة 6 (بنود عروض مرحلة ما قبل التوفّر للجمهور العام) من بنود الخدمة المحدّدة في "منصة خرائط Google"، وذلك وفقًا لما تم الاتفاق عليه بينك وبين Google.

‫1.1 متطلبات نسب العمل: على "العميل" تقديم معلومات تحديد المصدر إلى Google وفقًا للمستندات في حال استخدام "العميل" لمحتوى "خرائط Google" من Weather API.

‫1.2 القيود: لا يمكن للعملاء استخدام محتوى "خرائط Google" الذي تم استرجاعه من Weather API لإعادة إنشاء خدمة أو منتج من Google (على سبيل المثال، استخدام البيانات التي تم استرجاعها من Weather API في تطبيق أو نموذج خاص بالطقس يكون الغرض الأساسي منه تقديم معلومات عن الطقس).

‫1.3 التخزين المؤقت: يمكن للعملاء تخزين المحتوى الساري من "خرائط Google" مؤقتًا من Weather API خلال "فترة التخزين المؤقت" السارية، كما هو موضّح في الجدول 1.3.1 (أذونات التخزين المؤقت).

الجدول 1.3.1 (أذونات التخزين المؤقت)

تُضاف هذه الأذونات إلى الأذونات الموضّحة في الجدول 17.2.1 من "بنود الخدمة المحدّدة في منصة خرائط Google".

محتوى "خرائط Google" فترة التخزين المؤقت
مربّعات خريطة الطقس ساعة واحدة، وبعدها على "العميل" حذف "محتوى خرائط Google" المخزّن مؤقتًا

لمحة عن طلبات خريطة الطقس

لطلب خرائط الطقس، أرسِل طلب استرداد بيانات باستخدام GET HTTP إلى:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

أنواع الخرائط

تتيح Weather API أنواعًا مختلفة من خرائط الطقس تتوافق مع نماذج الطقس والمناطق الجغرافية الأساسية المختلفة:

  • US_PRECIPITATION_CURRENT: توقعات حالية عالية الدقة لهطول الأمطار في الولايات المتحدة
  • ‫EU_PRECIPITATION_CURRENT: توقعات حالية عالية الدقة لتساقط الأمطار في أوروبا

تعرض خريطة التغطية أدناه المناطق التي تتوفّر فيها مربّعات خرائط الطقس:

تغطية مربّعات خريطة الطقس

نظام إحداثيات المربّعات

تستخدِم واجهة برمجة التطبيقات نظام إحداثيات مربّعات Web Mercator المعياري. للحصول على شرح شامل لإحداثيات الخريطة والمربّعات، راجِع مربّعات خريطة الطريق وإحداثيات الخريطة والمربّعات.

في هذا النظام:

  • zoom: مستوى التكبير/التصغير (من 0 إلى 16). يمثّل مستوى التكبير/التصغير 0 العالم بأسره في مربّع واحد (20 × 20 = مربّع واحد). يقسّم مستوى التكبير/التصغير z العالم إلى شبكة من مربّعات 2z x 2z.
  • x: إحداثي X (العمود) للمربّع، ويتراوح بين 0 (الأكثر غربًا) و2مستوى التكبير/التصغير - 1 (الأكثر شرقًا).
  • y: إحداثي Y (الصف) للمربّع، ويتراوح بين 0 (الأبعد شمالاً) و2مستوى التكبير/التصغير - 1 (الأبعد جنوبًا).

عرض خريطة الطقس

لعرض هذه المربّعات في تطبيق ويب باستخدام Google Maps JavaScript API، يمكنك إنشاء google.maps.ImageMapType مخصّص:

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

مثال على طلب خريطة الطقس

يطلب المثال التالي الحصول على مربّعات خريطة الطقس الخاصة بهطول الأمطار في الولايات المتحدة لمدينة نيو أورلينز:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

الردّ ثنائي. لا يظهر برنامج تضمين JSON إلا ضمن إعدادات تسلسل معيّنة، مثل ?alt=json.