https://api.rainviewer.com/public/weather-maps.json
ประกอบด้วยข้อมูลเรดาร์ตรวจสภาพอากาศที่ผ่านมา (2 ชั่วโมง) และการพยากรณ์อากาศ (30 นาที) และข้อมูลดาวเทียมอินฟราเรดที่ผ่านมา (2 ชั่วโมง) เหมาะที่จะแสดงในแอปพลิเคชัน บนเว็บไซต์ หรือในซอฟต์แวร์การทำแผนที่อื่น ๆ นอกจากนี้ยังสามารถถูกใช้เป็นแหล่งที่มาสำหรับ API สภาพอากาศได้
นี่คือตัวอย่างไฟล์ API แผนที่สภาพอากาศที่มีสองเฟรมสำหรับแต่ละส่วนข้อมูล ข้อมูลในตัวอย่างล้าสมัยและไม่สามารถใช้ในการสืบค้นจริงได้ เพื่อรับข้อมูลจริง โปรดเปิดไฟล์ API โดยตรง
{
"version": "2.0",
"generated": 1609402525,
"host": "https://tilecache.rainviewer.com",
"radar": {
"past": [
{
"time": 1609401600,
"path": "/v2/radar/1609401600"
},
{
"time": 1609402200,
"path": "/v2/radar/1609402200"
}
],
"nowcast": [
{
"time": 1609402800,
"path": "/v2/radar/nowcast_6b3c5a659cf4"
},
{
"time": 1609403400,
"path": "/v2/radar/nowcast_dd3474d83b20"
}
]
},
"satellite": {
"infrared": [
{
"time": 1609401600,
"path": "/v2/satellite/0680143a9470"
},
{
"time": 1609402200,
"path": "/v2/satellite/ba88bf38ac55"
}
]
}
}
คีย์ | คำอธิบาย | ค่า | ตัวอย่าง |
---|---|---|---|
version | เวอร์ชัน API | String(8) | “2.0.1” |
generated | วันที่การประทับเวลา Unix (UTC) เมื่อสร้างไฟล์ API นี้ มีประโยชน์สำหรับการตรวจสอบการอัปเดต | Int(8) | 1609402525 |
host | โฮสต์และโปรโตคอลสำหรับรูปภาพ | String(255) | https://tilecache.rainviewer.com |
radar | แผนที่เรดาร์สภาพอากาศ | ออบเจ็คเรดาร์ | |
satellite | แผนที่ดาวเทียม | ออบเจ็คดาวเทียม |
คีย์ | คำอธิบาย | ค่า | ตัวอย่าง |
---|---|---|---|
past | เฟรมเรดาร์ตรวจอากาศที่ผ่านมา 2 ชั่วโมง พร้อมขั้นแบบ 10 นาที | อาเรย์(ออบเจ็คเฟรม) | |
nowcast | เฟรมเรดาร์ตรวจอากาศในอนาคต 30 นาทีหรือ 60 นาทีสำหรับ ผู้อุปถัมภ์ API ระดับ Gold+ และ Platinum | อาเรย์(ออบเจ็คเฟรม) |
คีย์ | คำอธิบาย | ค่า | ตัวอย่าง |
---|---|---|---|
infrared | ข้อมูลดาวเทียมอินฟราเรดย้อนหลัง 2 ชั่วโมง (ช่อง 13) จากดาวเทียมที่มีอยู่ | อาเรย์(ออบเจ็คเฟรม) |
คีย์ | คำอธิบาย | ค่า | ตัวอย่าง |
---|---|---|---|
time | จับคู่ข้อมูลการสร้างเฟรมในรูปแบบการประทับเวลา UNIX (UTC) เฟรมแผนที่โดยทั่วไปประกอบด้วยภาพ (เรดาร์ ดาวเทียม) จากช่วงเวลาต่าง ๆ ดังนั้นนี่ไม่ใช่เวลาของข้อมูล แต่เป็นเวลาในการสร้างเฟรม | Int(8) | 1609401600 |
path | แพตช์พื้นฐานสำหรับรูปภาพของเฟรมนั้น สำหรับข้อมูลเกี่ยวกับการใช้งาน โปรดดูที่ วิธีการใช้โฮสต์ และแพตช์ ข้อมูลในส่วนถัดไปของหน้านี้ | String(255) | /v2/satellite/0680143a9470 |
หากคุณชอบ API ของเราและต้องการให้มันใช้งานได้ฟรีนานที่สุด โปรดสนับสนุนเราที่ Patreon นอกจากนี้คุณยังจะสามารถเข้าถึง API ฐานข้อมูลเรดาร์ตรวจสภาพอากาศ แผนที่ 60 นาทีของเรดาร์ตรวจสภาพอากาศผ่านการพยากรณ์ปัจจุบัน และความเป็นไปได้ที่จะได้รับตารางชุดสีที่คุณกำหนดเอง
รับเป็นผู้อุปถัมภ์โฮสต์
และแพตช์
เช่นเดียวกับ legacy APIคุณต้องใช้ข้อมูล โฮสต์
และแพตช์
จาก API โดยเป็นส่วนหนึ่งของ URL URL และพารามิเตอร์ของ URL ที่มีอยู่ทั้งหมดได้ถูกอธิบายไว้ที่ด้านล่าง
แต่ละ url เริ่มต้นด้วย {host}
โดยที่:
{host}
คือ โฮสต์
จาก ออบเจ็ค Root ของ API นี้URL | คำอธิบาย |
---|---|
{path}/{size}/{z}/{x}/{y}/{color}/{options}.png | ข้อมูลเรดาร์: แสดงหนึ่งตารางพร้อมข้อมูลการสะท้อนเรดาร์คอมโพสิต พร้อมขนาดที่กำหนด ชุดรูปแบบสี และตัวเลือกเพิ่มเติม |
{path}/{size}/{z}/{lat}/{lon}/{color}/{options}.png | ข้อมูลเรดาร์: เหมือนกันกับลิงก์ด้านบน แต่มีจุดศูนย์กลางที่พิกัดเฉพาะ (EPSG:4326) พร้อมขนาดการซูมที่ต้องการ เหมาะสำหรับวิดเจ็ต |
{path}/{big_size}/{color}/{options}.png | ภาพคอมโพสิตที่มีการสะท้อนเรดาร์สำหรับทั้งโลก สร้างอย่างช้า ๆ สูงสุด 10 วินาทีต่อการโหลดภาพ ไม่สามารถปรับเรียบได้ สำคัญ: ชุดสีและมาสก์หิมะสำหรับข้อมูลดาวเทียมต้องเป็น “0” เสมอ |
{ts}
– หนึ่งในการประทับเวลา Unix ที่มีอยู่จาก API{x}, {y}, {z}
– x, y และระดับการซูมของตารางที่คุณต้องการดาวน์โหลด อ่านเพิ่มเติมเกี่ยวกับตาราง{latitude}, {longitude}
- ละติจูดและลองจิจูดของพิกัดเฉพาะตามลำดับ รูปแบบทศนิยม ต้องมีจุดในตัวเลข ตัวอย่างเช่น: -32.7892, 108.67821{size}
– ขนาดของภาพ สามารถเป็น 256 หรือ 512{big_size}
– สามารถเป็น 2000, 4000, 8000, 16000, หรือ 24000 (24000x12000 px หรือ ~2km ต่อพิกเซล) สำหรับรูปภาพสี่เหลี่ยมจัตุรัส ให้ใช้ 4096, 8192 และ 16384 ตามลำดับ{color}
- จำนวนชุดรูปแบบสีจากรายการที่มีให้{options}
– รายการตัวเลือกคั่นด้วยสัญลักษณ์ _
ตัวอย่างเช่น ‘1_0’ หมายถึงภาพที่ถูกปรับเรียบ (1) โดยไม่มีชุดรูปแบบสีหิมะ (0) ตอนนี้มีสองตัวเลือกให้ใช้: {smooth}_{snow}
{smooth}
- เบลอ (1) หรือไม่เบลอ (0) ข้อมูลเรดาร์ รูปภาพประกอบขนาดใหญ่มักจะไม่ราบเรียบเนื่องจากปัญหาด้านประสิทธิภาพ{snow}
- แสดง (1) หรือไม่แสดง (0) หิมะในชุดรูปแบบสีแยกกันบนตารางนอกจากนี้ยังมีอีกหนึ่งผลิตภัณฑ์พร้อมใช้งาน: มาสก์ครอบคลุมเรดาร์ตรวจอากาศ มาสก์นี้แสดงว่าเรดาร์ตรวจสภาพอากาศครอบคลุมพื้นที่ใดบ้าง (พื้นที่โปร่งใส) และพื้นที่ที่ไม่ครอบคลุม (พื้นที่สีดำ) เราไม่ได้อัปเดตมาสก์นี้บ่อย ลิงก์เหมือนกันกับผลิตภัณฑ์เรดาร์และดาวเทียม แต่ไม่มีตัวเลือกและชุดสี
URL | คำอธิบาย |
---|---|
/v2/coverage/0/{size}/{z}/{x}/{y}/0/0_0.png | ตารางความครอบคลุม: ที่มีข้อมูลเรดาร์ (พื้นที่โปร่งใส) และที่ไม่มี (พื้นที่สีดำ) |
/v2/coverage/0/{size}/{z}/{lat}/{lon}/0/0_0.png | ข้อมูลความครอบคลุมตามข้างต้น แต่สำหรับพิกัดศูนย์เฉพาะ (ละติจูด, ลองจิจูด) |
/v2/coverage/0/{big_size}/0/0_0.png | ตารางคอมโพสิตสำหรับทั้งโลกในเวลาเดียวกัน สร้างอย่างช้า ๆ |
โปรดดูหน้าตัวอย่างแยกกัน