Basic
Runnable OpenLayers example: Basic. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.
single HTML file · CDN dependencies onlyinterface may contain Chinese labels
Source
<!--
示例:OpenLayers 带图层的二维地图
要点:Map / View / TileLayer / VectorLayer 四件套,EPSG:3857 与经纬度互转
依赖:OpenLayers 10.3.1 · jsDelivr CDN
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>带图层的二维地图</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/ol@10.3.1/ol.css">
<style>
html,body{height:100%;margin:0}
body{display:flex;flex-direction:column;overflow:hidden;
font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif}
.bar{flex:0 0 auto;padding:8px 12px;background:#f6f7f9;border-bottom:1px solid #e3e6ea;
display:flex;gap:10px;align-items:center;font-size:12px;color:#58606e}
.bar label{display:flex;gap:5px;align-items:center;cursor:pointer}
#map{flex:1 1 auto;min-height:0;background:#eef0f3}
</style>
</head>
<body>
<div class="bar">
<label><input type="checkbox" id="tglVec" checked> 矢量图层</label>
<span id="info">—</span>
</div>
<div id="map"></div>
<script src="https://cdn.jsdelivr.net/npm/ol@10.3.1/dist/ol.js"></script>
<script>
(function () {
'use strict';
if (typeof ol === 'undefined') {
document.getElementById('map').innerHTML =
'<div style="padding:20px;color:#b42318">OpenLayers 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
return;
}
/* 经纬度转 Web 墨卡托,OpenLayers 默认使用 EPSG:3857 */
var fromLonLat = ol.proj.fromLonLat;
var center = fromLonLat([116.391263, 39.907359]);
var view = new ol.View({
center: center,
zoom: 12,
minZoom: 2,
maxZoom: 19
});
/* 底图:公开的 OSM 瓦片,不需要 Key */
var baseLayer = new ol.layer.Tile({
source: new ol.source.XYZ({url: 'https://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer/tile/{z}/{y}/{x}', attributions: 'Tiles © Esri'})
});
/* 矢量图层:三个经纬度点,在 3857 下需要转换 */
var features = [
[116.391263, 39.907359, '天安门'],
[116.410600, 39.914700, '王府井'],
[116.374200, 39.909700, '西单']
].map(function (p) {
var f = new ol.Feature({
geometry: new ol.geom.Point(fromLonLat([p[0], p[1]])),
name: p[2]
});
f.setStyle(new ol.style.Style({
image: new ol.style.Circle({
radius: 6,
fill: new ol.style.Fill({ color: '#1f5fd0' }),
stroke: new ol.style.Stroke({ color: '#ffffff', width: 2 })
}),
text: new ol.style.Text({
text: p[2],
offsetY: -14,
font: '500 12px sans-serif',
fill: new ol.style.Fill({ color: '#16181d' }),
stroke: new ol.style.Stroke({ color: '#ffffff', width: 3 })
})
}));
return f;
});
var vecLayer = new ol.layer.Vector({
source: new ol.source.Vector({ features: features })
});
var map = new ol.Map({
target: 'map',
layers: [baseLayer, vecLayer],
view: view,
controls: ol.control.defaults.defaults({
attribution: false,
zoom: true,
rotate: false
})
});
document.getElementById('tglVec').addEventListener('change', function () {
vecLayer.setVisible(this.checked);
});
/* 点击地图时读出经纬度 */
map.on('singleclick', function (evt) {
var lonlat = ol.proj.toLonLat(evt.coordinate);
document.getElementById('info').textContent =
lonlat[0].toFixed(6) + ', ' + lonlat[1].toFixed(6);
});
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.