下面给出一份「从零到上线」的完整流程,教你如何为网站申请并调用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地图。