实现常见地图场景样式时用：按用例选择并配置 Mapbox…

在开发餐厅/POI 查找、房产、数据可视化、导航、配送物流等地图场景时，快速套用经过验证的图层配置与样式模式。

适用场景

解决思路

1. 先判断主要展示内容：用户标记/图钉用 POI Finder 模式；房产数据/边界用 Real Estate 模式；统计/分析数据用 Data Visualization 模式；路线/导航用 Navigation 模式；实时追踪/配送区域用 Delivery/Logistics 模式（客户标记应通过第二个 circle 图层 + requestAnimationFrame + setPaintProperty 实现脉冲动画，详见 references/delivery-logistics.md）。
2. 再判断查看环境：白天/办公用浅色主题；夜间/暗环境用 Dark Mode 模式；环境多变则提供主题切换。
3. 再判断用户主要动作：浏览/探索时突出 POI 与丰富细节；导航时突出道路与路线可见性；追踪配送/物流时强调实时更新、区域与状态；分析数据时弱化底图、强化数据；选择位置时强调清晰边界与上下文。
4. 再判断平台：移动端简化样式、增大触控目标、减少细节；桌面端可包含更多细节与复杂度；两端兼顾时按移动优先设计，再为桌面增强。
5. 实现 Restaurant/POI Finder 模式时，按顺序配置图层：background 背景色 #f5f5f5；water 填充色 #d4e4f7、透明度 0.6；landuse-parks 过滤 class=park、填充色 #e8f5e8、透明度 0.5；roads-minor 过滤 class 为 street/street_limited、线色 #e0e0e0、线宽按 zoom 12/15/18 设为 0.5/2/6；roads-major 过滤 class 为 primary/secondary/tertiary、线色 #ffffff、线宽按 zoom 10/15/18 设为 1/4/12；restaurant-markers 使用 symbol 图层、icon-image restaurant-15、icon-size 1.5、icon-allow-overlap false、text-field 取 name、text-offset [0,1.5]、text-size 12、text-allow-overlap false、icon-color #FF6B35、text-color #333333、text-halo-color #ffffff、text-halo-width 2。
6. POI Finder 模式的关键特征：底图去饱和以免与照片竞争；标记高对比（#FF6B35 橙色突出）；道路网络清晰（浅灰底上白色道路）；公园可见但低调；文字加 halo 保证可读性。
7. 用按 zoom 简化的性能模式优化图层：对 roads 图层使用 step 表达式，zoom 小于 8 只显示 motorway/trunk，8 起加入 primary，12 起加入 secondary，14 起显示全部；线宽用 base 1.5、stops 为 [4,0.5]、[10,1]、[15,4]、[18,12]。
8. 按用例加载 references/ 下对应参考文件：real-estate.md（房产边界、价格配色、设施标记）、data-viz-base.md（灰度极简底图用于 choropleth/heatmap）、navigation.md（路线显示、用户位置、转向箭头）、dark-mode.md（近黑背景、降低亮度）、delivery-logistics.md（实时追踪、区域、司机标记、ETA 徽章）、expressions-clustering.md（数据驱动表达式 + 密集 POI 聚合）、common-modifications.md（3D 建筑、地形/山体阴影、自定义标记）、interactions.md（addInteraction vs setFeatureState vs appearances 的配合与选用）。
9. 实现配送追踪地图时加载 references/delivery-logistics.md，实现房产地图时加载 references/real-estate.md，以此类推按用例匹配参考文件。
10. 按视觉回归清单测试：在 zoom 4、8、12、16、20 下测试；验证移动端 375px 宽度；验证桌面端 1920px 宽度；用密集数据测试；用稀疏数据测试；检查标签碰撞；验证颜色对比度（WCAG）；测试加载性能。

适用边界 · 注意事项

• 不依赖 Mapbox 或不需要地图样式配置的项目不适用。
• 没有明确地图用例、只是随意调整样式时，不必套用这些固定模式。
• 无法访问 references/ 参考文件时，部分模式（房产、数据可视化、导航、暗色、配送物流等）无法完整实现。