萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

HTML5 Geolocation API 實戰:結合百度/谷歌地圖獲取精準地址

HTML5 Geolocation API 賦予 Web 應用獲取用戶地理位置的能力,結合地圖服務商的逆地理編碼接口,可將經緯度轉換為可讀的詳細地址。本文通過完整實例演示從權限申請、坐標獲取、錯誤處理到調用百度/谷歌地圖 API 落地的全流程。

核心 API 流程

function getLocation() {
    if (navigator.geolocation) {
        navigator.geolocation.getCurrentPosition(showPosition, showError);
    } else {
        alert("瀏覽器不支持地理定位。");
    }
}
  • getCurrentPosition(success, error, options):異步獲取位置,成功回調傳入 Position 對象(含 coords.latitude/longitude/accuracy 等)。
  • options 可設 enableHighAccuracy、timeout、maximumAge。

錯誤碼處理

function showError(error) {
    switch (error.code) {
        case error.PERMISSION_DENIED:   alert("用戶拒絕授權"); break;
        case error.POSITION_UNAVAILABLE: alert("位置信息不可用"); break;
        case error.TIMEOUT:             alert("獲取超時"); break;
        case error.UNKNOWN_ERROR:       alert("未知錯誤"); break;
    }
}

獲取經緯度並調用地圖 API

function showPosition(position) {
    var lat = position.coords.latitude;
    var lng = position.coords.longitude;
    var latlng = lat + "," + lng;

    // ---------- 百度地圖 ----------
    var baiduUrl = "https://api.map.baidu.com/geocoder/v2/?ak=您的AK&callback=renderReverse&location=" + latlng + "&output=json&pois=0";
    $.ajax({
        type: "GET", dataType: "jsonp", url: baiduUrl,
        beforeSend: function() { $("#baidu_geo").html("定位中..."); },
        success: function(json) {
            if (json.status === 0) $("#baidu_geo").html(json.result.formatted_address);
        },
        error: function() { $("#baidu_geo").html(latlng + " 百度獲取失敗"); }
    });

    // ---------- 谷歌地圖 ----------
    var googleUrl = "https://maps.google.cn/maps/api/geocode/json?latlng=" + latlng + "&language=CN";
    $.ajax({
        type: "GET", url: googleUrl,
        beforeSend: function() { $("#google_geo").html("定位中..."); },
        success: function(json) {
            if (json.status === "OK") {
                var addr = json.results[0].formatted_address;
                $("#google_geo").html(addr);
            }
        },
        error: function() { $("#google_geo").html(latlng + " 谷歌獲取失敗"); }
    });
}

關鍵注意事項

  1. HTTPS 強制:Chrome 50+ 要求安全上下文(HTTPS 或 localhost)才允許調用 Geolocation,HTTP 環境直接失敗。
  2. 用戶授權:首次訪問會彈窗請求權限,拒絕後需引導用戶在瀏覽器設置中開啟。
  3. AK/Key 管理:百度需申請 AK(應用密鑰),谷歌需 API Key,嚴禁硬編碼暴露在前端,建議後端代理轉發。
  4. 精度差異:GPS(手機)精度 ~10m;Wi-Fi/基站定位 ~50-200m;IP 定位僅城市級。enableHighAccuracy:true 會嘗試啟用 GPS,耗電且耗時。
  5. 降級策略:定位失敗時可回退至 IP 定位庫(如 ipapi、高德 IP 定位)給出城市級兜底。

擴展應用場景

  • LBS 簽到/打卡、周邊 POI 推薦
  • 物流/外賣實時追蹤(配合 watchPosition 持續監聽)
  • 表單自動填充收貨地址
  • 區域性內容分發、合規攔截

掌握 Geolocation + 逆地理編碼組合,能為 Web 應用賦予強大的位置感知能力,構建更智能的用戶體驗。

copyright © 萬盛學電腦網 all rights reserved