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

mapTypes Endpoint จะให้ไทล์แผนที่แรสเตอร์ที่แสดงปรากฏการณ์สภาพอากาศต่างๆ เช่น พยากรณ์การเกิดฝน ลูกเห็บ หรือหิมะตก คุณสามารถวางซ้อนไทล์แผนที่เหล่านี้บน 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: การพยากรณ์อากาศปัจจุบันเกี่ยวกับปริมาณน้ำฝนในยุโรปที่มีความละเอียดสูง

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

ความครอบคลุมของการ์ดแผนที่สภาพอากาศ

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

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