Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

ในระบบนี้

zoom: ระดับการซูม (0 ถึง 16) ระดับการซูม 0 แสดงโลกทั้งใบ ในแผนที่ย่อยเดียว (2⁰ x 2⁰ = 1 แผนที่ย่อย) ระดับการซูม z จะแบ่งโลกออกเป็นตารางกริดของแผนที่ย่อย 2^z x 2^z
x: พิกัด X (คอลัมน์) ของแผนที่ย่อย ซึ่งมีค่าตั้งแต่ 0 (ตะวันตกสุด) ถึง 2^zoom - 1 (ตะวันออกสุด)
y: พิกัด Y (แถว) ของแผนที่ย่อย ซึ่งมีค่าตั้งแต่ 0 (เหนือสุด) ถึง 2^zoom - 1 (ใต้สุด)

แสดงแผนที่สภาพอากาศ

หากต้องการแสดง Map Tiles เหล่านี้ในเว็บแอปพลิเคชันโดยใช้ 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);

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

ตัวอย่างต่อไปนี้จะขอ Map Tiles แผนที่สภาพอากาศปริมาณน้ำฝนของสหรัฐอเมริกาสำหรับนิวออร์ลีนส์

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