先從最小可用範例開始,這是一張以倫敦為中心的街道地圖:
<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
function initialize() {
var mapProp = {
center: new google.maps.LatLng(51.508742, -0.120850),
zoom: 5,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:380px;"></div>
</body>
</html>

<!DOCTYPE html> 這行不能省。多數瀏覽器只有在看到 HTML5 的 DOCTYPE 時才會進入「標準模式」渲染;缺少它,瀏覽器會退回 quirks mode(相容模式),而某些 CSS 在相容模式下的行為與標準模式完全不同。
這裡還有個容易忽略的細節:基於百分比的尺寸會從父元素繼承,若父層沒有明確高度,百分比就會塌成 0。想讓地圖填滿整個視窗,得逐層宣告高度:
<style type="text/css">
html { height: 100% }
body { height: 100%; margin: 0; padding: 0 }
#googleMap { height: 100% }
</style>
引入 API 的那個 script 標籤有兩個參數要注意:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&sensor=TRUE_OR_FALSE"></script>
key 放你在 Google 後台申請的 API Key;sensor 則用來告知 API 你的應用是否會使用 GPS 這類感測器來定位使用者,填 true 或 false。
若你的網站走 HTTPS,記得把協定換成 https,避免混合內容被瀏覽器攔下:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&sensor=TRUE_OR_FALSE"></script>
如果不想讓地圖 API 拖慢首屏,可以等頁面完全載入後再動態插入 script:
<!DOCTYPE html>
<html>
<head>
<script>
function initialize() {
var mapProp = {
center: new google.maps.LatLng(51.508742, -0.120850),
zoom: 7,
mapTypeId: google.maps.MapTypeId.ROADMAP
};
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
}
function loadScript() {
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false&callback=initialize";
document.body.appendChild(script);
}
window.onload = loadScript;
</script>
</head>
<body>
<div id="googleMap" style="width:500px;height:500px;"></div>
</body>
</html>
關鍵在 URL 尾端的 callback=initialize:API 載入完成後會自動呼叫這個函式,初始化流程因此有了明確的時機點。
center(中心點):用 google.maps.LatLng(緯度, 經度) 指定地圖的視覺中心。
zoom(縮放級數):0 是整個地球,數字越大看得越近。
mapTypeId(地圖型別):四種可選值——
・ROADMAP:標準街道圖
・SATELLITE:衛星影像
・HYBRID:衛星影像疊加街道資訊
・TERRAIN:地形圖,呈現起伏與植被
地圖需要一個容器,慣例是用 div:
<div id="googleMap" style="width:500px;height:380px;"></div>
地圖的實際尺寸就是這個 div 的尺寸,想改大小改這裡就好。
var map = new google.maps.Map(document.getElementById("googleMap"), mapProp);
這行做了兩件事:找到 id 為 googleMap 的元素,並套用 mapProp 的設定。想在同一頁放多張地圖,只要準備更多 div 與更多 Map 物件即可,例如同時展示四種型別:
<html>
<head>
<script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyDY0kkJiTPVd2U7aTOAwhc9ySH6oHxOIYM&sensor=false"></script>
<script>
function initialize() {
var base = { center: new google.maps.LatLng(51.508742, -0.120850), zoom: 9 };
var mapProp = Object.assign({}, base, { mapTypeId: google.maps.MapTypeId.ROADMAP });
var mapProp2 = Object.assign({}, base, { mapTypeId: google.maps.MapTypeId.SATELLITE });
var mapProp3 = Object.assign({}, base, { mapTypeId: google.maps.MapTypeId.HYBRID });
var mapProp4 = Object.assign({}, base, { mapTypeId: google.maps.MapTypeId.TERRAIN });
new google.maps.Map(document.getElementById("googleMap"), mapProp);
new google.maps.Map(document.getElementById("googleMap2"), mapProp2);
new google.maps.Map(document.getElementById("googleMap3"), mapProp3);
new google.maps.Map(document.getElementById("googleMap4"), mapProp4);
}
google.maps.event.addDomListener(window, 'load', initialize);
</script>
</head>
<body>
<div id="googleMap" style="width:400px;height:300px;"></div><br>
<div id="googleMap2" style="width:400px;height:300px;"></div><br>
<div id="googleMap3" style="width:400px;height:300px;"></div><br>
<div id="googleMap4" style="width:400px;height:300px;"></div>
</body>
</html>
google.maps.event.addDomListener(window, 'load', initialize);
這行的意義是確保初始化在頁面完全載入後才執行。若在 DOM 尚未就緒時就試圖取得 getElementById,只會拿到 null,地圖自然畫不出來。