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

هذا المنتج أو الميزة يتوفران في النسخة التجريبية (ما قبل التوفّر للجمهور العام). قد يكون الدعم المقدّم للمنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات هنا متوافقة مع الإصدارات الأخرى من هذه المرحلة. تخضع عروض مرحلة ما قبل التوفّر للجمهور العام لبنود الخدمة المحدّدة في منصة خرائط Google. لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

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

ملاحظة: قد لا تكون مربّعات خريطة الطقس متزامنة أو متوافقة مع البيانات التي توفّرها نقطة النهاية forecast:minute.

البنود

تم إصدار هذه البنود بموجب القسم 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 إلى:

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

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

لعرض هذه المربّعات في تطبيق ويب باستخدام 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.