feat: add Gaode Map search support with configurable API key and JWT authentication

Author: chenxuan520

README.md

@@ -29,7 +29,7 @@ RoadbookMaker是一个功能强大的基于网页的地图标记和路线规划
 
 ### 地图操作
 - **多地图源支持**: OpenStreetMap、高德地图、Google地图、ESRI卫星图等
-- **智能搜索**: 集成Photon、Nominatim、Overpass、百度地图、天地图等多种搜索服务
+- **智能搜索**: 集成Photon、Nominatim、Overpass、高德地图、百度地图、天地图等多种搜索服务
 - **坐标转换**: 自动处理中国地图坐标系（GCJ-02、BD-09）到标准GPS的转换
 
 ### 标记点管理
@@ -113,6 +113,29 @@ cd roadbook
       ./roadbook-api
       ```
 
+   d. **(可选) 配置高德地图搜索**
+      本项目已支持高德地图搜索。如需启用，请在 `backend/configs/config.json` 文件中添加 `search` 配置块，并填入您自己的高德 API Key。
+
+      **配置示例：**
+      ```json
+      {
+        "port": 5436,
+        "...": "...",
+        "search": {
+          "providers": {
+            "gaode": {
+              "key": "your_gaode_api_key_here",
+              "login_required": false
+            }
+          }
+        }
+      }
+      ```
+      - `key` (string): 您的高德Web服务API Key。
+      - `login_required` (boolean, 可选): 设置为 `true` 时，调用高德搜索接口需要进行JWT登录认证。默认为 `false`（公开访问）。
+
+      如果`key`字段为空或没有此`search`配置块，高德搜索将不可用。
+
 3. **配置Nginx** (可选但推荐)
 ```bash
 sudo cp ./nginx.prod.conf /etc/nginx/sites-available/roadbook
@@ -310,6 +333,7 @@ roadbook/
 ### 地图搜索服务
 - `GET /api/cnmap/search?q={query}` - 百度地图搜索
 - `GET /api/tianmap/search?q={query}` - 天地图搜索
+- `GET /api/gaode/search?q={query}` - 高德地图搜索
 
 ### 用户认证
 - `POST /api/v1/login` - 用户登录（限流保护）

backend/internal/config/config.go

@@ -23,7 +23,8 @@ type Config struct {
 
 // SearchProviderConfig holds configuration for a single search provider, like an API key.
 type SearchProviderConfig struct {
-	Key string `json:"key"`
+	Key          string `json:"key"`
+	LoginRequired bool   `json:"login_required,omitempty"`
 }
 
 // SearchProviders holds configurations for all supported search providers.

backend/internal/handler/search.go

@@ -10,19 +10,29 @@ import (
 	"github.com/gin-gonic/gin"
 )
 
-func GaodeSearchHandler(apiKey string) gin.HandlerFunc {
-	return func(c *gin.Context) {
-		query := c.Query("q")
-		results, err := gaode.Search(query, apiKey)
-		if err != nil {
-			c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
-			return
-		}
-		c.JSON(http.StatusOK, results)
+// SearchHandlers holds dependencies for search-related handlers.
+type SearchHandlers struct {
+	cfg config.Config
+}
+
+// NewSearchHandlers creates a new instance of SearchHandlers.
+func NewSearchHandlers(cfg config.Config) *SearchHandlers {
+	return &SearchHandlers{cfg: cfg}
+}
+
+// GaodeSearchHandler handles Gaode search requests.
+func (h *SearchHandlers) GaodeSearchHandler(c *gin.Context) {
+	query := c.Query("q")
+	results, err := gaode.Search(query, h.cfg.Search.Providers.Gaode.Key)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
 	}
+	c.JSON(http.StatusOK, results)
 }
 
-func BaiduSearchHandler(c *gin.Context) {
+// BaiduSearchHandler handles Baidu search requests.
+func (h *SearchHandlers) BaiduSearchHandler(c *gin.Context) {
 	query := c.Query("q")
 	results, err := baidu.Search(query)
 	if err != nil {
@@ -32,7 +42,8 @@ func BaiduSearchHandler(c *gin.Context) {
 	c.JSON(http.StatusOK, results)
 }
 
-func TianmapSearchHandler(c *gin.Context) {
+// TianmapSearchHandler handles Tianmap search requests.
+func (h *SearchHandlers) TianmapSearchHandler(c *gin.Context) {
 	query := c.Query("q")
 	results, err := tianmap.Search(query)
 	if err != nil {
@@ -43,18 +54,25 @@ func TianmapSearchHandler(c *gin.Context) {
 }
 
 type ProviderStatus struct {
-	Name    string `json:"name"`
-	Enabled bool   `json:"enabled"`
-	Label   string `json:"label"`
+	Name          string `json:"name"`
+	Enabled       bool   `json:"enabled"`
+	Label         string `json:"label"`
+	LoginRequired bool   `json:"login_required"`
 }
 
-func GetSearchProvidersHandler(cfg config.Config) gin.HandlerFunc {
-	return func(c *gin.Context) {
-		providers := []ProviderStatus{
-			{Name: "tianmap", Enabled: true, Label: "天地图"},
-			{Name: "baidu", Enabled: true, Label: "百度"}, // baidu is hardcoded, so always "enabled" from backend pov
-			{Name: "gaode", Enabled: cfg.Search.Providers.Gaode.Key != "", Label: "高德"},
-		}
-		c.JSON(http.StatusOK, providers)
+// GetSearchProvidersHandler handles requests for search provider status.
+func (h *SearchHandlers) GetSearchProvidersHandler(c *gin.Context) {
+	// NOTE: For providers like baidu and tianmap that don't have a login_required config yet,
+	// the default value of a boolean in Go is false, which is the desired behavior.
+	providers := []ProviderStatus{
+		{Name: "tianmap", Enabled: true, Label: "天地图", LoginRequired: false},
+		{Name: "baidu", Enabled: true, Label: "百度", LoginRequired: false},
+		{
+			Name:          "gaode",
+			Enabled:       h.cfg.Search.Providers.Gaode.Key != "",
+			Label:         "高德",
+			LoginRequired: h.cfg.Search.Providers.Gaode.LoginRequired,
+		},
 	}
+	c.JSON(http.StatusOK, providers)
 }

backend/internal/server/server.go

@@ -61,6 +61,7 @@ func NewRouter(cfg config.Config) *gin.Engine {
 
 	authHandler := handler.NewAuthHandler(authService)
 	planHandler := handler.NewPlanHandler(planRepo)
+	searchHandlers := handler.NewSearchHandlers(cfg) // Create search handlers instance
 
 	// API v1 路由组
 	v1 := r.Group("/api/v1")
@@ -100,13 +101,23 @@ func NewRouter(cfg config.Config) *gin.Engine {
 	{
 		api.GET("/ping", handler.Ping)
 		api.HEAD("/ping", handler.Ping)
-		api.GET("/cnmap/search", handler.BaiduSearchHandler)
-		api.GET("/tianmap/search", handler.TianmapSearchHandler)
-		api.GET("/gaode/search", handler.GaodeSearchHandler(cfg.Search.Providers.Gaode.Key))
-		api.GET("/search/providers", handler.GetSearchProvidersHandler(cfg))
+		api.GET("/cnmap/search", searchHandlers.BaiduSearchHandler)
+		api.GET("/tianmap/search", searchHandlers.TianmapSearchHandler)
+		api.GET("/gaode/search", applyAuthMiddleware(cfg.Search.Providers.Gaode.LoginRequired, authService, searchHandlers.GaodeSearchHandler)...)
+		api.GET("/search/providers", searchHandlers.GetSearchProvidersHandler)
 		// 新增trafficpos接口
 		api.GET("/trafficpos", handler.GetTrafficPos)
 	}
 
 	return r
 }
+
+// applyAuthMiddleware conditionally applies JWTAuthMiddleware if loginRequired is true,
+// returning a HandlersChain suitable for gin.
+func applyAuthMiddleware(loginRequired bool, authService auth.Authenticator, handler gin.HandlerFunc) gin.HandlersChain {
+	if loginRequired {
+		return gin.HandlersChain{middleware.JWTAuthMiddleware(authService), handler}
+	}
+	return gin.HandlersChain{handler}
+}
+

static/index.html

@@ -27,14 +27,14 @@ <h1 id="mainTitle">RoadbookMaker</h1>
                     <input type="text" id="searchInput" placeholder="搜索地点...">
                     <select id="searchMethodSelect" class="btn" style="background: linear-gradient(135deg, rgba(255,255,255,0.3), rgba(255,255,255,0.15)); color: #fff; border: 2px solid rgba(255,255,255,0.5); padding: 0.6rem 1.2rem; border-radius: 25px; font-size: 0.9rem; font-weight: 600; cursor: pointer; margin-left: 0.5rem;">
                         <option value="auto">🗺️自动分配搜索</option>
-                        <option value="gaode">🤩高德搜索</option>
-                        <option value="nominatim">😓Nominatim搜索</option>
-                        <option value="overpass">😓Overpass搜索</option>
-                        <option value="mapsearch">😀MapSearch搜索</option>
-                        <option value="photon">😀Photon搜索</option>
+                        <option value="nominatim">Nominatim搜索</option>
+                        <option value="overpass">Overpass搜索</option>
+                        <option value="mapsearch">MapSearch搜索</option>
+                        <option value="photon">Photon搜索</option>
                         <!-- fxxk you baidu map -->
-                        <option value="cnsearch" style="display:none;">🤩CNSearch搜索</option>
-                        <option value="tiansearch">🤩TianSearch搜索</option>
+                        <option value="cnsearch" style="display:none;">CNSearch搜索</option>
+                        <option value="gaode">高德搜索</option>
+                        <option value="tiansearch">TianSearch搜索</option>
                     </select>
                     <!-- 搜索结果下拉框 -->
                     <div id="searchResults" class="search-results" style="display: none;">