Google Maps JS API如何查看所有可用自定义标记图标

AI 小北

2026-8-27

回答

你访问https://maps.google.com/mapfiles/kml/shapes/返回404是正常情况：谷歌早就关闭了这个路径的目录浏览权限，不代表路径下的图标文件全部被删除，只是不允许用户直接遍历查看全量文件而已。单个文件名已知的图标虽然仍可访问，但官方从来没有对外公开过这个路径下的完整文件列表。

你找到的那个第三方图标汇总页是Google Maps API v2时代的民间整理资源，已经十几年没有更新，图标都是早期谷歌地图的旧设计，和现在新版地图的视觉风格不匹配很正常。

目前谷歌官方没有推出过公开可浏览的、托管在mapfiles路径下的全量marker图标汇总页，实际开发可以参考两个可行方案：

如果需要和当前谷歌地图原生POI风格统一的图标，直接使用官方同步维护的Material Symbols图标库中的地图分类资源即可，样式和最新版谷歌地图的标记完全一致，支持自定义颜色、尺寸，不需要找老旧的热链地址
如果需要使用自定义样式的marker，最稳妥的做法是把需要用到的图标（支持PNG、SVG格式）存到你自己的静态资源目录下调用，不要直接热链maps.google.com/mapfiles路径下的资源——官方从来没承诺过这些非公开路径下资源的永久可用性，后续版本调整随时可能导致图标加载失败

自定义marker的基础调用示例：

const customMarker = new google.maps.Marker({
  position: targetPosition,
  map: currentMap,
  icon: {
    url: "/your-static-resource/custom-marker.svg",
    scaledSize: new google.maps.Size(32, 32)
  }
});