DIV CSS 佈局教程網

HTML5 地理位置定位實戰:取得經緯度並轉為真實地址
編輯:JavaScript綜合知識     

用相對簡單的 JavaScript,就能做出能取得使用者地理位置的 Web 應用,包含經緯度甚至海拔。有些應用甚至能追蹤位置隨時間的變化來提供導航,並整合 Google Maps 這類地圖服務。本文示範如何取得座標,再進一步換算成人看得懂的地址。

Geolocation API 是什麼

定位功能(Geolocation)是 HTML5 的新特性,只能在支援 HTML5 的現代瀏覽器上執行,行動裝置(如 iPhone)上的精度通常更高。使用前必須先偵測瀏覽器是否支援,支援才呼叫定位。

隱私是關鍵:這個特性涉及使用者隱私,除非使用者明確同意,否則位置資訊不可取得。所以頁面會跳出「是否允許定位」的提示,必須使用者按下允許才會繼續。

基本流程

function getLocation() {
    if (navigator.geolocation) {
        navigator.geolocation.getCurrentPosition(showPosition, showError);
    } else {
        alert("瀏覽器不支援地理定位。");
    }
}

getCurrentPosition() 的第一個參數是成功時呼叫的函式,會收到一個 coordinates 物件;第二個參數是失敗時呼叫的錯誤處理函式。

錯誤處理

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;
    }
}

實務上 PERMISSION_DENIED 是最常見的,尤其在 iframe 內或使用者曾經按過「封鎖」之後。這時應引導使用者到瀏覽器設定中手動開放,而不是只跳一個 alert 就結束。

取得經緯度

function showPosition(position) {
    var lat = position.coords.latitude;   // 緯度
    var lag = position.coords.longitude;  // 經度
    alert('緯度:' + lat + ',經度:' + lag);
}

把經緯度轉成地址

經緯度對使用者沒有意義,我們需要把它換成「臺北市○○區○○路」這樣的可讀資訊。幸運的是各家地圖服務都提供了逆地理編碼(reverse geocoding)接口,只要把座標傳過去,就會回傳省市區甚至街道門牌的資訊。

先在頁面準備兩個展示用的容器:

<div id="baidu_geo"></div>
<div id="google_geo"></div>

百度地圖接口

function showPosition(position) {
    var latlon = position.coords.latitude + ',' + position.coords.longitude;

    // baidu
    var url = "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK&callback=renderReverse"
            + "&location=" + latlon + "&output=json&pois=0";
    $.ajax({
        type: "GET",
        dataType: "jsonp",
        url: url,
        beforeSend: function () {
            $("#baidu_geo").html('正在定位...');
        },
        success: function (json) {
            if (json.status == 0) {
                $("#baidu_geo").html(json.result.formatted_address);
            }
        },
        error: function (XMLHttpRequest, textStatus, errorThrown) {
            $("#baidu_geo").html(latlon + " 地址位置獲取失敗");
        }
    });
}

百度回傳的是 JSONP 格式的資料,可依需求取出省市區街道等欄位。這裡用到 jQuery,記得先載入。

Google 地圖接口

function showPosition(position) {
    var latlon = position.coords.latitude + ',' + position.coords.longitude;

    // google
    var url = 'https://maps.google.cn/maps/api/geocode/json?latlng=' + latlon + '&language=CN';
    $.ajax({
        type: "GET",
        url: url,
        beforeSend: function () {
            $("#google_geo").html('正在定位...');
        },
        success: function (json) {
            if (json.status == 'OK') {
                var results = json.results;
                $.each(results, function (index, array) {
                    if (index == 0) {
                        $("#google_geo").html(array['formatted_address']);
                    }
                });
            }
        },
        error: function (XMLHttpRequest, textStatus, errorThrown) {
            $("#google_geo").html(latlon + " 地址位置獲取失敗");
        }
    });
}

Google 回傳的也是 JSON,而且資訊比百度更細緻,results 陣列的第一項通常就是最完整的格式化地址。

幾個實務上的關鍵點

  • 務必使用 HTTPS。這不是選項而是必要條件——所有主流瀏覽器都已在非安全環境中停用 Geolocation API,http 頁面直接呼叫會失敗。
  • 範例中的 API 網址已失效或變更。百度已改用 api.map.baidu.com/reverse_geocoding 並要求 ak 與伺服器端簽名;Google 的 maps.google.cn 網域也已調整,現行應使用 maps.googleapis.com/maps/api/geocode/json 並搭配 API key。請勿直接把範例中的 key 拿去用。
  • 不要在前端暴露 API key。逆地理編碼的請求應由自己的後端代理轉發,key 留在伺服器端,同時可以加上快取與流量控制。
  • 加上 timeout 與降級方案。室內或訊號差時定位可能失敗,可傳入第三個 options 參數:getCurrentPosition(ok, fail, { timeout: 8000, maximumAge: 60000, enableHighAccuracy: false }),並準備讓使用者手動輸入地址的後路。
  • 不要追蹤使用者。除非功能確實需要,否則避免呼叫 watchPosition 持續追蹤,並在使用者離開時用 clearWatch 停止,這既是隱私要求也是電量考量。

這個例子可以延伸出很多應用:附近店家、到店服務、天氣查詢、區域內容推薦。但記得把「取得位置」當成一個需要正當理由的敏感操作來對待,清楚的說明與合理的降級,比技術實作本身更影響使用者信任。

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