下面給出一份「從零到上線」的完整流程,教你如何為網站申請并調用Google地圖(Google Maps JavaScript API)。按順序操作即可。

一、申請Google Maps API Key

注冊/登錄Google Cloud

打開Google Cloud Console(https://console.cloud.google.com/)并用Google賬號登錄。

創建項目

點擊頂部「選擇項目」→「新建項目」,輸入名稱后創建。

啟用結算(Billing)

地圖API必須綁定信用卡/借記卡,按調用量計費。首次啟用通常有200美元/月的免費額度。

啟用API

左側菜單「API和服務」→「庫」→搜索并啟用以下3個API:

Maps JavaScript API

Geocoding API(地址?經緯度互轉時會用到)

Places API(地點搜索、自動補全)

創建憑據

「API和服務」→「憑據」→「創建憑據」→「API密鑰」。生成后復制Key,后面代碼里要用。

限制Key(防刷)

點擊剛創建的Key→「設置」→把「HTTP引薦來源」填成你的網站域名,例如wodepress.com,保存。

二、在網頁里加載地圖(最簡可運行示例)

把下面代碼添加到簡站wordpress外貿主題的wp-contact.php文件中需要顯示的位置,把YOUR_API_KEY換成剛才申請的Key,瀏覽器打開即可看到地圖。

<div id="map"></div>

    <!-- 1. 加載 Maps JS API -->
    <script>
      (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{
        await (a=m.createElement("script"));e.set("libraries",[]);e.set("key",g.key);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)
      }));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
      ({key: "YOUR_API_KEY", v: "weekly"});
    </script>

    <!-- 2. 初始化地圖 -->
    <script>
      let map;
      async function initMap() {
        const { Map } = await google.maps.importLibrary("maps");
        map = new Map(document.getElementById("map"), {
          center: { lat: 39.9042, lng: 116.4074 }, // 北京
          zoom: 12,
          mapId: "DEMO_MAP_ID", // 可留空,用于高級樣式
        });
      }
      initMap();
    </script>

三、常見下一步需求

加標記(Marker)

引入marker庫后new google.maps.Marker({position,map,title})即可。

地址解析/逆解析

啟用Geocoding API后,用new google.maps.Geocoder().geocode({address:’北京市海淀區’},callback)。

地點搜索/自動補全

啟用Places API,用new google.maps.places.Autocomplete(inputDom)。

路線規劃

啟用Directions API,用new google.maps.DirectionsService().route(request,callback)。

四、上線前checklist

把Key的HTTP引薦來源改成生產域名。

監控配額:Console→「API和服務」→「配額」可設每日上限,防止異常流量。

國內用戶訪問慢,可讓頁面先加載「maps.google.cn」的腳本,再把域名統一成「maps.googleapis.com」即可。

至此,你的網站就成功接入了Google地圖。