调用gdal2tiles生成的瓦片无法在地图显示，函数调用缺什么参数？

问题原因及缺失参数说明 #

你当前调用的generate_tiles方法缺失了3个直接影响瓦片命名、坐标规则的核心参数，默认值和MapTiler的通用切片规则不匹配，所以出现瓦片无法加载的问题：

• tms_compatibility：控制瓦片Y轴编号规则，gdal2tiles默认开启TMS规范（Y轴从南到北递增），而MapTiler及绝大多数通用地图服务默认使用XYZ规范（Y轴从北到南递增），二者Y坐标完全翻转，这是最核心的命名差异来源。你需要显式配置tms_compatibility=False关闭TMS兼容，对齐通用XYZ规则。
• profile：指定切片的空间参考规则，默认值为mercator（对应Web墨卡托EPSG:3857）。如果你的原始tif是WGS84（EPSG:4326）等其他坐标系，或者需要匹配MapTiler的切片坐标系，必须显式指定该参数，可选值为mercator/geodetic/raster三类，坐标系不匹配会导致瓦片整体坐标偏移无法显示。
• resampling_method：重采样规则，虽然不会直接导致命名差异，但如果原始影像分辨率和目标缩放层级不匹配，默认的重采样方式可能导致瓦片内容失真，显式指定和MapTiler一致的lanczos重采样即可保证内容一致性。

修正后的调用示例 #

gdal2tiles.generate_tiles(
    input_file, 
    f"output_folder", 
    nb_processes=1, 
    zoom='24-27',
    tms_compatibility=False,
    profile='mercator',
    resampling_method='lanczos'
)

快速验证方法 #

取相同层级、相同X坐标的瓦片，如果你原有输出的Y值和MapTiler输出的Y值之和等于2^当前缩放层级 - 1，即可确认是Y轴翻转问题，仅添加tms_compatibility=False即可解决绝大多数此类异常。

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