الحصول على مفتاح Maps Demo Key: يمكنك تجربة Weather API بدون أي تكلفة باستخدام مفتاح Maps Demo Key، ولا يلزم توفير معلومات الفوترة.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

توفّر نقطة النهاية 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" المخزَّن مؤقتًا

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

لطلب خرائط الطقس، أرسِل طلب HTTP GET إلى:

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 العالم بأكمله في مربّع واحد (2⁰ × 2⁰ = مربّع واحد). يقسّم مستوى التكبير z العالم إلى شبكة من المربّعات تبلغ مساحتها 2^z x 2^z.
‫x: الإحداثي X (العمود) للقِسم، ويتراوح من 0 (أقصى الغرب) إلى 2^zoom - 1 (أقصى الشرق).
‫y: الإحداثي Y (الصف) للمربّع، ويتراوح من 0 (أقصى الشمال) إلى 2^zoom - 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.