מבוא
שכבות-על הן אובייקטים במפה שמקושרים אל
קואורדינטות של קו רוחב/אורך, כך שהן יזוזו כאשר אתם גוררים או
שינוי מרחק התצוגה במפה. אם רוצים למקם תמונה במפה, אפשר להשתמש
אובייקט GroundOverlay
.
למידע על סוגים אחרים של שכבות-על, אפשר לעיין במאמר שרטוט על המפה.
הוספת שכבת-על של קרקע
ה-constructor של
GroundOverlay
מציין כתובת URL של תמונה
ואת LatLngBounds
של התמונה כפרמטרים. התמונה
להיות מוצגים במפה, מוגבלים לגבולות הנתונים,
באמצעות ההיטל של המפה.
TypeScript
// This example uses a GroundOverlay to place an image on the map // showing an antique map of Newark, NJ. let historicalOverlay; function initMap(): void { const map = new google.maps.Map( document.getElementById("map") as HTMLElement, { zoom: 13, center: { lat: 40.74, lng: -74.18 }, } ); const imageBounds = { north: 40.773941, south: 40.712216, east: -74.12544, west: -74.22655, }; historicalOverlay = new google.maps.GroundOverlay( "https://storage.googleapis.com/geo-devrel-public-buckets/newark_nj_1922-661x516.jpeg", imageBounds ); historicalOverlay.setMap(map); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
JavaScript
// This example uses a GroundOverlay to place an image on the map // showing an antique map of Newark, NJ. let historicalOverlay; function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 13, center: { lat: 40.74, lng: -74.18 }, }); const imageBounds = { north: 40.773941, south: 40.712216, east: -74.12544, west: -74.22655, }; historicalOverlay = new google.maps.GroundOverlay( "https://storage.googleapis.com/geo-devrel-public-buckets/newark_nj_1922-661x516.jpeg", imageBounds, ); historicalOverlay.setMap(map); } window.initMap = initMap;
כדאי לנסות דוגמה
הסרת שכבת-על של קרקע
כדי להסיר שכבת-על מהמפה, קוראים לפונקציה
השיטה setMap()
, מעבירה את null
. שימו לב
קריאה לשיטה הזו לא מוחקת את שכבת-העל. הוא מסיר
את שכבת-העל מהמפה. אם במקום זאת רוצים למחוק את שכבת-העל,
צריך להסיר אותו מהמפה ואז להגדיר את
כשכבת-על מעל null
.
function removeOverlay() { historicalOverlay.setMap(null); }