CartoDB开源版Maps API是否支持列出命名地图？本地部署问题咨询

首先明确：本地部署的CartoDB完全支持Named Maps（即你提到的地图模板）的列出、修改等API操作，你遇到的请求无效问题，大概率是配置、权限或者环境细节没到位，下面给你几个针对性的排查方向：

1. 先确认Named Maps功能是否开启 #

本地部署的CartoDB需要手动确保Named Maps模块启用。找到你的CartoDB配置文件（一般是env.yml或者部署目录下的核心配置文件），检查是否有以下配置项并设置为true：

named_maps_enabled: true

如果之前是关闭状态，修改后记得重启CartoDB所有服务才能生效。

2. 检查API请求的基础信息是否正确 #

你用的请求是curl -X GET 'https://cartotest.localhost.lan/api/v1/map/named?api_key=APIKEY'，这里有两个常见坑：

• 本地部署如果没配置HTTPS证书，大概率要用http协议而非https，试试把请求改成：

  curl -X GET 'http://cartotest.localhost.lan/api/v1/map/named?api_key=APIKEY'
  

• 确认APIKEY是对应用户的主API密钥，不是只读或受限密钥。你可以在CartoDB控制台的用户设置页面里查看、生成主密钥。

3. 验证用户权限是否足够 #

确保你用的API密钥对应的用户拥有管理Named Maps的权限：

• 如果是普通用户，需要管理员在后台给该用户分配Named Maps相关权限；
• 如果是管理员账号，默认应该有全部权限，但也要检查配置文件里是否有针对管理员的权限限制。

4. 查看服务日志找具体错误 #

如果请求还是没反应，去看CartoDB的服务日志（通常在/var/log/cartodb或者部署目录的log文件夹下），重点看maps-api相关的日志文件。日志里会明确给出错误原因，比如认证失败、配置错误、模板不存在等，这是定位问题最快的方式。

5. 先创建一个测试模板再验证 #

如果是列出请求返回空，可能当前用户下还没有任何Named Maps模板。可以先通过API创建一个测试模板，再尝试列出，比如用这个请求（替换成你的用户名、API密钥和表名）：

curl -X POST 'http://cartotest.localhost.lan/api/v1/map/named' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "test_template",
    "auth": {
      "method": "open"
    },
    "layergroup": {
      "version": "1.0.1",
      "layers": [
        {
          "type": "cartodb",
          "options": {
            "table_name": "your_test_table",
            "cartocss": "#your_test_table { marker-fill: #FF0000; }"
          }
        }
      ]
    }
  }' \
  -u "your_username:APIKEY"

另外提醒下：如果你用的是较旧版本的本地CartoDB，API细节可能和最新的云版文档有差异，建议核对你部署的具体版本对应的官方文档。

内容的提问来源于stack exchange，提问作者user2108603