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

ปลายทาง 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: การพยากรณ์ปริมาณน้ำฝนในสหรัฐอเมริกาแบบ Nowcast ที่มีความละเอียดสูง
  • 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