DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
用 HTML5 Geolocation API 取得使用者地理位置
編輯:HTML5教程     

HTML5 的 navigator.geolocation 讓網頁能取得使用者的經緯度。瀏覽器只負責回報座標,若要知道「這是哪個縣市哪個鄉鎮」,還需要搭配地圖服務的反向地理編碼 API。以下範例用百度地圖的 Geocoding 介面把座標換算成行政區。

程式碼

/**
 * 取得地理位置
 */
function getLocation() {
    // 檢查瀏覽器是否支援地理位置
    if (navigator.geolocation) {
        var config = { enableHighAccuracy: true, timeout: 5000, maximumAge: 30000 };
        // 成功呼叫 showPosition,失敗呼叫 showError
        navigator.geolocation.getCurrentPosition(showPosition, showError, config);
    } else {
        alert("此瀏覽器不支援定位,或使用者已停用位置權限");
    }
}

/**
 * 定位成功
 */
function showPosition(position) {
    var x = position.coords.latitude;
    var y = position.coords.longitude;

    // 呼叫地圖服務做反向地理編碼
    var url = "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK"
            + "&callback=renderReverse"
            + "&location=" + x + "," + y
            + "&output=json"
            + "&pois=0";

    $.ajax({
        type: "GET",
        dataType: "jsonp",
        url: url,
        success: function (json) {
            if (json == null || typeof (json) == "undefined") return;
            if (json.status != "0") return;
            setAddress(json.result.addressComponent);
        },
        error: function () {
            alert("[" + x + "," + y + "] 地址解析失敗,請手動選擇地址");
        }
    });
}

/**
 * 定位失敗
 */
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;
    }
}

/**
 * 填入地址
 */
function setAddress(json) {
    var position = document.getElementById("txtPosition");
    var province = json.province;
    var city = json.city;
    var district = json.district;
    province = province.replace('市', '');
    position.value = province + "," + city + "," + district;
    position.style.color = 'black';
}

幾個實務上必須知道的細節

一定要用 HTTPS。現代瀏覽器已把 Geolocation 列為需要安全內容的 API,在 http 頁面呼叫會直接被拒絕。這段範例寫於當時,現在必須加上這個前提。

務必處理使用者拒絕的情況。定位屬於隱私敏感功能,使用者按下「不要」是很正常的。程式中 PERMISSION_DENIED 的分支不是裝飾,而是主要的失敗路徑,應該提供手動輸入或選擇的替代方案。

三個設定參數的意義:enableHighAccuracy 為 true 時會要求更高精度(可能改用 GPS,較耗電也較慢);timeout 是等待上限;maximumAge 允許回傳幾毫秒以內的快取值,設大一點能加快回應但精度較舊。

API Key 要自己申請。範例中的 ak 參數必須向地圖服務商申請,不能直接沿用他人金鑰;正式環境建議把這類呼叫放到自己的後端代理,避免金鑰曝光在客戶端。

注意座標系統差異。不同地圖服務使用的座標系(WGS84、GCJ-02、BD-09)並不相同,混用會導致數百公尺的偏移,跨服務整合時需要轉換。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved