วัตถุประสงค์
API คุณภาพอากาศและละอองเกสรช่วยให้คุณเพิ่ม ข้อมูลเชิงลึกเกี่ยวกับการเดินทางหรือแผนที่ในสถานที่หนึ่งๆ ได้มากขึ้น คุณใช้ข้อมูลที่ได้จาก API เหล่านั้นได้ 2 วิธี ได้แก่ ดัชนีเป็นข้อความหรือไทล์แผนที่ความหนาแน่นเป็นภาพแรสเตอร์

ขณะใช้ปลายทาง API ของไทล์แผนที่ความหนาแน่น คุณอาจพบปัญหาบางอย่างขณะโหลดไทล์แรสเตอร์แต่ละรายการ เช่น
- วิธีโหลดไทล์ใน Google Maps บนเว็บ (และเพื่อให้เป็นไปตามข้อกำหนดในการใช้งาน API ด้วย)
- วิธีจัดการจำนวนคำขอระหว่างการใช้งาน
- วิธีอ่านค่าไทล์
กรณีการใช้งานตัวอย่าง
คุณจะเห็นตัวอย่างกรณีการใช้งานเพื่อลองตอบคำถามข้างต้น
- คุณภาพอากาศและละอองเกสรดอกไม้ในพื้นที่: แสดงภาพข้อมูลแรสเตอร์ชิ้นส่วนแผนที่ความหนาแน่น (สภาพปัจจุบัน) ภายในรูปหลายเหลี่ยมที่กำหนดเอง 1 รูปหรือหลายรูป
- คุณภาพอากาศและละอองเกสรดอกไม้ตามเส้นทาง: แสดงภาพข้อมูลแรสเตอร์ไทล์แผนที่ความหนาแน่น (สภาพปัจจุบัน) ที่แมปบนจุดอ้างอิงของเส้นทาง
การใช้งาน
คุณจะได้ทราบว่ามีไทล์ใดบ้างที่พร้อมใช้งานและวิธีโหลดไทล์เหล่านั้นในประสบการณ์การใช้งานบนเว็บ นอกจากนี้ คุณยังจะได้เห็นวิธีจัดการจำนวนคำขอในสถานการณ์ที่มีการโหลดไทล์ลงในแผนที่ สุดท้าย ระบบจะแสดงวิธีอ่านการ์ด
การ์ดแผนที่ความหนาแน่นที่ใช้ได้ตามประเภท
Air Quality API
- UAQI_RED_GREEN (UAQI, red-green palette): จานสีแดง-เขียวของดัชนีคุณภาพอากาศสากล
- UAQI_INDIGO_PERSIAN (UAQI, จานสีน้ำเงินคราม-เปอร์เซีย): จานสีน้ำเงินคราม-เปอร์เซียของดัชนีคุณภาพอากาศสากล
- PM25_INDIGO_PERSIAN: จานสีน้ำเงินเข้ม-ม่วงของดัชนี PM2.5
- GBR_DEFRA: จานสีดัชนีคุณภาพอากาศรายวัน (สหราชอาณาจักร)
- DEU_UBA: จานสีดัชนีคุณภาพอากาศในพื้นที่ของเยอรมนี
- CAN_EC: จานสีดัชนีคุณภาพอากาศและสุขภาพของแคนาดา
- FRA_ATMO: จานสีดัชนีคุณภาพอากาศของฝรั่งเศส
- US_AQI: จานสีดัชนีคุณภาพอากาศของสหรัฐอเมริกา
Pollen API
- TREE_UP: ประเภทแผนที่ความหนาแน่นจะแสดงแผนที่กราฟิกดัชนีแบบต้นไม้
- GRASS_UPI: ประเภทแผนที่ความหนาแน่นจะแสดงแผนที่กราฟิกดัชนีหญ้า
- WEED_UPI: ประเภทแผนที่ความหนาแน่นจะแสดงแผนที่ดัชนีวัชพืชในรูปแบบกราฟิก
แสดงการ์ดแผนที่ความหนาแน่นในเว็บ
โหลดไทล์และใช้มาสก์เวกเตอร์เพื่อแสดงเฉพาะพื้นที่ที่ต้องการในวิวพอร์ตของแผนที่
กำลังโหลดการ์ด
- ใช้ Maps JavaScript API เพื่อโหลดแผนที่ฐานของ Google และโหลดไลบรารี deckgl เพื่อเตรียมโหลดรูปภาพชิ้นส่วนแผนที่แบบราสเตอร์
- ใช้ TileLayer ของ deck.gl เพื่อโหลดไทล์แผนที่ความหนาแน่นของคุณภาพอากาศ ซึ่งจะแสดงป้ายกำกับแผนที่ฐานของ Google Maps ที่ด้านบนของชิ้นส่วนแผนที่ความหนาแน่น (ต่างจากการวางซ้อนที่กำหนดเองของ Maps JavaScript)
import { TileLayer } from "deck.gl"; import { GoogleMapsOverlay } from "@deck.gl/google-maps"; // const TileLayer = deck.TileLayer; // const GoogleMapsOverlay = deck.GoogleMapsOverlay; // Initialize and add the map function initMap() { const map = new google.maps.Map(document.getElementById("map"), { center: { lat: 40, lng: -110 }, zoom: 4, }); const apiKey = 'YOUR_API_KEY'; const airqualityType = 'UAQI_RED_GREEN' // AirQuality API heatmap type const deckOverlay = new GoogleMapsOverlay({ layers: [ // Heatmap Tiles layer new TileLayer({ id: 'heatmap-tiles', data: 'https://airquality.googleapis.com/v1/mapTypes/'+ heatmapType + +'/heatmapTiles/{z}/{x}/{y}?key=' + apiKey, ... }) ], }); deckOverlay.setMap(map); } window.initMap = initMap;
การใช้เวกเตอร์มาสก์
คุณสามารถซ่อนหรือแสดงส่วนใดก็ได้ของไทล์แผนที่ความหนาแน่น สำคัญ: คุณจะต้องรับข้อมูลที่จะใช้สร้างมาสก์เวกเตอร์ที่ใช้กับไทล์แผนที่ความหนาแน่น
- ในพื้นที่:
ใช้ deck.gl GeoJson เพื่อสร้างมาสก์เหนือ TileLayer ของคุณภาพอากาศ
ตัวอย่างด้านล่างใช้ GeoJSON แบบรูปหลายเหลี่ยมหลายรูปของฝรั่งเศส
// geojson sample { "type": "Feature", "geometry": { "type": "MultiPolygon", "coordinates": [[[[-54.111527,2.11427],...[-54.194491,2.163073]]]] }, "properties": { "name": "France" } }
ข้อมูลอ้างอิงสำหรับการติดตั้งใช้งาน deckgl มีดังนี้
// Loaded layers in maps overlay const deckOverlay = new GoogleMapsOverlay({ layers: layers }); const MaskExtension = deck.MaskExtension; // or import extension ... // As part of object containing the different layers const layers = [ // Masking layer new GeoJsonLayer({ id: 'country-vector', operation: 'mask', data: "geojson.json", // <-- any custom geometry }) ... ... // Heatmap Tiles layer new TileLayer({ id: 'heatmap-tiles', maskId: 'country-vector', // <-- same as mask id extensions: [new MaskExtension()], // <-- enable mask extension ... }) ]
- ตามเส้นทาง: ใช้ deck.gl กับ TripsLayer เพื่อสร้าง Mask เหนือ TileLayer ของคุณภาพอากาศ
ไทล์แผนที่ความหนาแน่นของคุณภาพอากาศตลอดการเดินทาง
จัดการคำขอ API และค่าใช้จ่าย
แม้ว่าลักษณะการทำงานเริ่มต้นของเบราว์เซอร์มักจะเป็นการแคชชิ้นส่วนที่โหลดทั้งหมดในพื้นที่เก็บข้อมูลในเครื่อง (ภายในเซสชันเดียวกัน) แต่คุณสามารถเพิ่มประสิทธิภาพเพิ่มเติมได้ดังนี้
- จำกัดพื้นที่การโหลด: สร้างกรอบล้อมรอบ (สีแดง) และกำหนดให้กับเลเยอร์ โดยระบบจะโหลดเฉพาะไทล์แผนที่ความหนาแน่น (สีน้ำเงิน) ที่ครอบคลุมกรอบล้อมรอบที่ระดับการซูมที่กำหนด
กรอบล้อมรอบ (สีแดง), ไทล์แผนที่ความหนาแน่น (สีน้ำเงิน)
// Heatmap Tile layer new TileLayer({ id: 'heatmap-tiles', extent: [minX, minY, maxX, maxY] // bounding box: southwest lat, southwest lng, northeast lat, northeast lng ... })
- ตั้งค่าขนาดไทล์การแสดงผลภาพให้ครอบคลุมทั้งวิวพอร์ตที่ระดับการซูมที่กำหนด โดยขนาดที่แนะนำคือระหว่าง 256 ถึง 1024
สำคัญ: ชิ้นส่วน API จะยังคงมีความละเอียด 256x256 แต่การปรับการแสดงผลภาพจะช่วยให้คุณเพิ่ม/ลดจำนวนคำขอชิ้นส่วนเพื่อให้ครอบคลุมวิวพอร์ตแผนที่ทั้งหมดได้
(ตรวจสอบว่าใช้ได้กับ minZoom และ maxZoom ของ Google Maps เช่น
tilesize:1024จะไม่โหลดการ์ดที่ระดับการซูม 0 หรือ 1)
วิวพอร์ตที่มีไทล์ขนาด 256x256 พิกเซลเทียบกับ 512x512 พิกเซล
// Heatmap Tile layer new TileLayer({ id: 'heatmap-tiles', tilesize:256, // <-- change to 512 for instance ... })
อ่านค่าพิกเซล
หากต้องการแสดงค่าที่สอดคล้องกันในสเกลสี
คุณสามารถใช้ไลบรารี Luma.gl และเมธอด readPixelsToArray กับเหตุการณ์ onClick ที่กำหนดเป็นพร็อพเพอร์ตี้ให้กับเลเยอร์ deck.gl
ค่าพิกเซล: rgba(128,0,0,255)
ต่ำ
สูง
// Uint8Array pixel sample import { readPixelsToArray } from "@luma.gl/core"; ... // assign on the TileLayer new TileLayer({ id: 'heatmap-tiles', ... onClick: ({ bitmap, layer }) => { if (bitmap) { const pixel = readPixelsToArray(layer.props.image, { sourceX: bitmap.pixel[0], sourceY: bitmap.pixel[1], sourceWidth: 1, sourceHeight: 1 }); // console.log("color picked:"+ pixel); } } })
บทสรุป
คุณได้ทราบวิธีใช้ปลายทาง API ของไทล์แผนที่ความหนาแน่นของคุณภาพอากาศและละอองเกสร ดังนี้
- โหลดใน Google Maps บนเว็บ และตรวจสอบว่าเป็นไปตามข้อกำหนดในการใช้งาน
- เพิ่มประสิทธิภาพให้ตรงกับกรณีการใช้งานของคุณ
- อ่านค่าการ์ด
การดำเนินการถัดไป
ข้อมูลเพิ่มเติมที่แนะนำให้อ่าน
ผู้ร่วมให้ข้อมูล
ผู้เขียนหลัก:
Thomas Anglaret | วิศวกรโซลูชัน Google Maps Platform