ภาพรวม
Google Maps API มีภาพแผนที่ที่หลากหลายใน ระดับการซูมต่างๆ สำหรับภาพแผนที่ ตัวอย่างเช่น ภาพแผนที่ส่วนใหญ่จะพร้อมใช้งานตั้งแต่ระดับการซูม 0 ถึง 18 ภาพถ่ายจากดาวเทียมมีความหลากหลายมากกว่าเนื่องจากภาพเหล่านี้ไม่ได้สร้างขึ้น แต่ถ่ายทำโดยตรง
เนื่องจากภาพถ่ายดาวเทียมอาจไม่พร้อมใช้งานในระดับการซูมสูงสำหรับสถานที่ห่างไกล เช่น พื้นที่ที่มีประชากรเบาบางหรือพื้นที่มหาสมุทรเปิด คุณจึงควรทราบระดับการซูมสูงสุดสำหรับภาพในพื้นที่หนึ่งๆ ล่วงหน้า ออบเจ็กต์ MaxZoomService
มีอินเทอร์เฟซที่เรียบง่ายสําหรับค้นหาระดับการซูมสูงสุด ณ สถานที่หนึ่งๆ ที่ Google Maps มีภาพถ่ายจากดาวเทียม
คำขอ MaxZoom
การเข้าถึง MaxZoomService
เป็นแบบไม่พร้อมกัน เนื่องจาก Google Maps API จำเป็นต้องเรียกใช้เซิร์ฟเวอร์ภายนอก คุณจึงต้องส่งเมธอด callback เพื่อดำเนินการเมื่อคําขอเสร็จสมบูรณ์ เมธอด Callback นี้ควรประมวลผลผลลัพธ์
หากต้องการเริ่มคําขอไปยัง MaxZoomService
ให้เรียกใช้ getMaxZoomAtLatLng()
โดยส่ง LatLng
ของตําแหน่ง และฟังก์ชันการเรียกกลับเพื่อดําเนินการเมื่อคําขอเสร็จสมบูรณ์
คำตอบของ MaxZoom
เมื่อ getMaxZoomAtLatLng()
เรียกใช้ฟังก์ชัน callback
ระบบจะส่งพารามิเตอร์ 2 รายการกลับ
status
มีMaxZoomStatus
ของคําขอzoom
มีระดับการซูม หากบริการดำเนินการไม่สำเร็จด้วยเหตุผลบางประการ ค่านี้จะไม่แสดง
รหัส status
อาจแสดงผลค่าใดค่าหนึ่งต่อไปนี้
OK
บ่งบอกว่าบริการพบระดับการซูมสูงสุดสำหรับภาพถ่ายดาวเทียมERROR
บ่งบอกว่าระบบไม่สามารถดำเนินการตามคำขอ MaxZoom ได้
ตัวอย่างต่อไปนี้แสดงแผนที่ของมหานครโตเกียว การคลิกที่ใดก็ได้บนแผนที่จะระบุระดับการซูมสูงสุด ณ ตำแหน่งนั้น (โดยทั่วไประดับการซูมรอบๆ โตเกียวจะอยู่ระหว่างระดับ 18 ถึง 21)
TypeScript
let map: google.maps.Map; let maxZoomService: google.maps.MaxZoomService; let infoWindow: google.maps.InfoWindow; function initMap(): void { map = new google.maps.Map(document.getElementById("map") as HTMLElement, { zoom: 11, center: { lat: 35.6894, lng: 139.692 }, mapTypeId: "hybrid", }); infoWindow = new google.maps.InfoWindow(); maxZoomService = new google.maps.MaxZoomService(); map.addListener("click", showMaxZoom); } function showMaxZoom(e: google.maps.MapMouseEvent) { maxZoomService.getMaxZoomAtLatLng( e.latLng as google.maps.LatLng, (result: google.maps.MaxZoomResult) => { if (result.status !== "OK") { infoWindow.setContent("Error in MaxZoomService"); } else { infoWindow.setContent( "The maximum zoom at this location is: " + result.zoom ); } infoWindow.setPosition(e.latLng); infoWindow.open(map); } ); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
JavaScript
let map; let maxZoomService; let infoWindow; function initMap() { map = new google.maps.Map(document.getElementById("map"), { zoom: 11, center: { lat: 35.6894, lng: 139.692 }, mapTypeId: "hybrid", }); infoWindow = new google.maps.InfoWindow(); maxZoomService = new google.maps.MaxZoomService(); map.addListener("click", showMaxZoom); } function showMaxZoom(e) { maxZoomService.getMaxZoomAtLatLng(e.latLng, (result) => { if (result.status !== "OK") { infoWindow.setContent("Error in MaxZoomService"); } else { infoWindow.setContent( "The maximum zoom at this location is: " + result.zoom, ); } infoWindow.setPosition(e.latLng); infoWindow.open(map); }); } window.initMap = initMap;