ดูแผนที่สภาพอากาศ (ทดลอง)

mapTypes ปลายทางจะให้ไทล์แผนที่แรสเตอร์ที่แสดงปรากฏการณ์สภาพอากาศต่างๆ เช่น พยากรณ์การเกิดฝน ลูกเห็บ หรือหิมะตก คุณสามารถวางซ้อนไทล์แผนที่เหล่านี้บน Google Maps มาตรฐานได้

ข้อกำหนด

ข้อกำหนดเหล่านี้ออกภายใต้ส่วนที่ 6 (ข้อกำหนดของข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ของข้อกำหนดเฉพาะบริการของ Google Maps Platform ตามที่ Google และคุณตกลงกัน

1.1 ข้อกำหนดในการระบุแหล่งที่มา ลูกค้าต้องระบุแหล่งที่มาให้ Google ตามเอกสารประกอบหากใช้เนื้อหา Google Maps จาก Weather API

1.2 ข้อจำกัด ลูกค้าไม่สามารถใช้เนื้อหา Google Maps ที่ดึงมาจาก Weather API เพื่อสร้างบริการหรือผลิตภัณฑ์ของ Google ขึ้นใหม่ (เช่น ใช้ข้อมูลที่ดึงมาจาก Weather API ในแอปหรือโมเดลสภาพอากาศที่มีวัตถุประสงค์หลักเพื่อ ให้ข้อมูลสภาพอากาศ)

1.3 การแคช ลูกค้าสามารถแคชเนื้อหา Google Maps ที่เกี่ยวข้องจาก Weather API ชั่วคราวสำหรับระยะเวลาการแคชที่เกี่ยวข้องตามที่อธิบายไว้ในตาราง 1.3.1 (สิทธิ์ในการแคช)

ตาราง 1.3.1 (สิทธิ์ในการแคช)

สิทธิ์เหล่านี้เป็นสิทธิ์เพิ่มเติมจากที่อธิบายไว้ในตาราง 17.2.1 ของข้อกำหนดเฉพาะบริการของ Google Maps Platform

เนื้อหาของ Google Maps ระยะเวลาแคช
การ์ดแผนที่สภาพอากาศ 1 ชั่วโมง หลังจากนั้นลูกค้าต้องลบเนื้อหา Google Maps ที่แคชไว้

เกี่ยวกับคำขอแผนที่สภาพอากาศ

หากต้องการขอแผนที่สภาพอากาศ ให้ส่งคำขอ GET HTTP ไปยัง

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

ประเภทแผนที่

Weather API รองรับแผนที่สภาพอากาศประเภทต่างๆ ซึ่งสอดคล้องกับ โมเดลสภาพอากาศและพื้นที่ทางภูมิศาสตร์ที่แตกต่างกัน ดังนี้

  • US_PRECIPITATION_CURRENT: การพยากรณ์อากาศปัจจุบันเกี่ยวกับปริมาณน้ำฝนในสหรัฐอเมริกาความละเอียดสูง
  • EU_PRECIPITATION_CURRENT: การพยากรณ์อากาศปัจจุบันเกี่ยวกับฝนตกในยุโรปที่มีความละเอียดสูง

แผนที่ความครอบคลุมด้านล่างแสดงภูมิภาคที่ไทล์แผนที่สภาพอากาศพร้อมให้บริการ

ความครอบคลุมของ Map Tiles สภาพอากาศ

ระบบพิกัดแผนที่ย่อย

API ใช้ระบบพิกัดไทล์ Web Mercator มาตรฐาน ดูคำอธิบายโดยละเอียดเกี่ยวกับพิกัดแผนที่และไทล์ได้ที่ไทล์แผนที่ถนนและพิกัดแผนที่และไทล์

ในระบบนี้

  • zoom: ระดับการซูม (0 ถึง 16) ระดับการซูม 0 แสดงทั้งโลก ในไทล์เดียว (20 x 20 = 1 ไทล์) ระดับการซูม z จะแบ่งโลกออกเป็นตารางกริดขนาด 2z x 2z
  • x: พิกัด X (คอลัมน์) ของไทล์ ซึ่งมีค่าตั้งแต่ 0 (ตะวันตกสุด) ถึง 2zoom - 1 (ตะวันออกสุด)
  • y: พิกัด Y (แถว) ของไทล์ โดยมีค่าตั้งแต่ 0 (เหนือสุด) ถึง 2zoom - 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"

การตอบกลับเป็นแบบไบนารี Wrapper JSON จะปรากฏภายใต้การตั้งค่าการซีเรียลไลซ์ที่เฉพาะเจาะจงเท่านั้น เช่น ?alt=json