如何通过GeoServer REST自动下载GeoServer图层预览（.GIF）

• 核对完整请求参数
  手动下载时，GeoServer预览页生成的URL包含多个关键参数，自动化请求必须完全匹配。你可以通过浏览器开发者工具的「网络面板」查看手动下载时的请求详情，确保参数无遗漏，标准的WMS GetMap请求格式如下：

  http://你的GeoServer地址/geoserver/wms?service=WMS&version=1.1.0&request=GetMap&layers=工作区名:图层名&styles=&bbox=最小经度,最小纬度,最大经度,最大纬度&width=800&height=600&srs=EPSG:4326&format=image/gif
  

  重点确认bbox、srs、format这几个参数，任何拼写或数值错误都会导致请求失败。

• 处理身份验证
  如果你的GeoServer开启了权限控制，手动操作时浏览器会保存会话Cookie，自动化请求需要带上认证信息：

  • 若用HTTP Basic认证，在请求头中添加Authorization: Basic [用户名:密码的Base64编码值]
  • 若用表单登录认证，需要先发送POST请求到登录接口获取Cookie，后续所有请求都携带该Cookie

• 正确处理请求与响应
  GeoServer的WMS GetMap接口默认使用GET请求，确保自动化脚本用GET方法发起请求，并且直接将响应的二进制流保存为文件，而不是解析文本。以Python为例：

  import requests
  
  url = "http://你的GeoServer地址/geoserver/wms"
  params = {
      "service": "WMS",
      "version": "1.1.0",
      "request": "GetMap",
      "layers": "工作区名:目标图层",
      "bbox": "110.0,30.0,120.0,40.0",
      "width": 800,
      "height": 600,
      "srs": "EPSG:4326",
      "format": "image/gif"
  }
  # 若需要认证，添加auth参数
  auth = ("用户名", "密码")
  response = requests.get(url, params=params, auth=auth)
  
  with open("图层预览.gif", "wb") as f:
      f.write(response.content)
  

• 确认格式参数的准确性
  必须保证请求中的format参数是image/gif，GeoServer严格遵循MIME类型匹配，使用gif这类简写会导致请求无法正确识别格式。

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