萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 集成 Google Maps API 顯示地圖與標記

在 PHP 頁面中嵌入 Google Maps,可動態展示地點、路線、自定義標記。本文演示如何通過 PHP 生成 JavaScript 配置,實現地圖縮放級別、地圖類型(普通/衛星/混合)切換、地址地理編碼等功能。

核心流程

  1. PHP 端接收參數(縮放級別、地圖類型),或調用 Geocoding API 解析地址獲取經緯度。
  2. 將參數輸出到頁面 JavaScript 變量。
  3. 前端 GMap2 (v2) 或 google.maps.Map (v3) 初始化地圖、添加標記。

完整示例 (Google Maps API v2 風格,示意)

<?php
function selected($param, $value) {
    if ($param == $value) echo 'SELECTED';
}

// 1. 獲取參數
$scale = isset($_REQUEST['scale']) ? (int)$_REQUEST['scale'] : 10;
$maptype = $_REQUEST['maptype'] ?? 'G_NORMAL_MAP';

// 2. 地理編碼(實際應緩存結果)
// $location = file_get_contents("https://maps.google.com/maps/geo?q=48+Spa+Road,+Melksham,+UK&output=csv&key=YOUR_KEY");
// list($stat, $acc, $north, $east) = explode(',', $location[0]);
// 演示用硬編碼
$north = 51.369318;
$east = -2.133457;
?>
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Well House Manor, Melksham</title>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=3"></script>
    <script>
        function initMap() {
            var map = new google.maps.Map(document.getElementById('map'), {
                center: {lat: <?= $north ?>, lng: <?= $east ?>},
                zoom: <?= $scale ?>,
                mapTypeId: google.maps.MapTypeId.<?= str_replace('G_', '', $maptype) ?> // ROADMAP/SATELLITE/HYBRID
            });
            var marker = new google.maps.Marker({
                position: {lat: <?= $north ?>, lng: <?= $east ?>},
                map: map,
                title: 'Well House Manor'
            });
        }
    </script>
</head>
<body onload="initMap()">
    <h1>Well House Manor, Melksham</h1>
    <form method="GET">
        縮放:
        <select name="scale" onchange="this.form.submit()">
            <option value="7" <?= selected($scale,7) ?>>概覽</option>
            <option value="10" <?= selected($scale,10) ?>>縣級</option>
            <option value="13" <?= selected($scale,13) ?>>城鎮</option>
            <option value="16" <?= selected($scale,16) ?>>街道</option>
            <option value="19" <?= selected($scale,19) ?>>建築</option>
        </select>
        類型:
        <select name="maptype" onchange="this.form.submit()">
            <option value="ROADMAP" <?= selected($maptype,'ROADMAP') ?>>普通地圖</option>
            <option value="SATELLITE" <?= selected($maptype,'SATELLITE') ?>>衛星圖</option>
            <option value="HYBRID" <?= selected($maptype,'HYBRID') ?>>混合</option>
        </select>
    </form>
    <div id="map" style="width:100%; height:500px;"></div>
</body>
</html>

關鍵點說明

  • API Key:需在 Google Cloud Console 創建項目、啟用 Maps JavaScript API、設置 HTTP Referrer 限制。
  • Geocoding API:將地址轉經緯度,受配額限制,務必緩存結果(資料庫/Redis),避免重複請求。
  • 版本差異:v2 (GMap2) 已棄用,生產環境請使用 v3 (google.maps.Map)。
  • HTTPS:生產環境強制 HTTPS,否則瀏覽器會阻塞混合內容。
  • 成本控制:Maps JS API 按地圖加載次數計費,建議設置配額告警。

進階功能擴展

  • 信息窗口:點擊標記顯示詳情(InfoWindow)。
  • 多標記聚合:大量標記時使用 MarkerClusterer 庫。
  • 路線規劃:DirectionsService 計算駕車/步行/騎行/大眾運輸路線。
  • 地點搜索:Places Autocomplete 實現地址輸入提示。
  • 樣式化地圖:StyledMapType 自定義顏色、隱藏 POI 等。

安全最佳實踐

  1. API Key 限制 HTTP Referrer、IP、應用包名。
  2. 服務端代理 Geocoding/Places 請求,隱藏 Key、合併緩存、統一錯誤處理。
  3. 前端輸出動態數據時,使用 json_encode() 並設置 JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP 防 XSS。

Google Maps 功能強大、文檔完善,PHP 僅作為配置數據輸出層,核心交互邏輯在前端 JavaScript 實現,前後端分離架構更利於維護與擴展。

copyright © 萬盛學電腦網 all rights reserved