介绍
在上一篇文章中，我们探讨了 SwiftUI 中新的 MapKit API 的基础知识。现在，让我们深入 MapKit API 的定制点，以便根据我们的需求定制地图呈现。
地图样式
新的 MapKit API 引入了 mapStyle 视图修饰符，使我们能够自定义地图上呈现的数据样式。
struct ContentView: View {
var body: some View {
Map {
// ...
}
.mapStyle(.imagery(elevation: .realistic))
}
}在上面的示例中，我们使用了 mapStyle 视图修饰符，并使用了 imagery 样式和逼真的高程。imagery 样式的高程参数的另一个选项是 flat。
imagery-map
SwiftUI 为我们提供了一套预定义且可配置的地图样式。在前面的示例中，我们使用了一个称为 imagery 的样式。默认情况下，SwiftUI 框架使用标准样式。标准样式允许我们配置地图的高程、要包括或排除的兴趣点，以及是否需要显示交通信息。
代码语言：swift复制struct ContentView: View {
var body: some View {
Map {
// ...
}
.mapStyle(
.standard(
elevation: .flat,
pointsOfInterest: .excluding([.store]),
showsTraffic: false
)
)
}
}另一个选项是混合样式，允许在地图上显示影像、道路和道路名称。混合样式还配置了高程、交通和兴趣点。
代码语言：swift复制struct ContentView: View {
var body: some View {
Map {
// ...
}
.mapStyle(
.hybrid(
elevation: .flat,
pointsOfInterest: .including([.airport]),
showsTraffic: true
)
)
}
}地图交互
MapKit 支持与地图的不同类型交互，包括缩放、平移、倾斜和旋转地图上的内容。默认情况下，SwiftUI 激活所有可用手势，但你可以轻松将可用交互限制为首选交互的列表。
代码语言：swift复制struct ContentView: View {
var body: some View {
Map(interactionModes: [.pan, .pitch]) {
// ...
}
}
}地图控件
每当将 MapKit 与 SwiftUI 一起导入时，你将获得可用作地图控件的特定 SwiftUI 视图。这些视图包括 MapScaleView、MapCompass、MapPitchToggle、MapUserLocationButton 和 MapZoomStepper 视图。
struct ContentView: View {
var body: some View {
Map {
// ...
}
.mapControls {
MapScaleView()
MapCompass()
}
}
}你可以将这些视图与 mapControls 视图修饰符一起使用，为在 SwiftUI 视图层次结构中共享相同环境的任何地图实例指定控件。当你将 MapScaleView 或 MapCompass 视图放在 mapControls 视图修饰符内时，SwiftUI 会处理控件的放置，具体取决于运行应用的平台。
这些地图控件是简单的 SwiftUI 视图，这意味着你可以在 mapControls 视图修饰符之外的任何位置使用它们。在这种情况下，要将地图控件绑定到特定的地图实例，你应该使用 mapScope 视图修饰符。
struct MapScopeExample: View {
@Namespace private var favoritesMap
var body: some View {
VStack {
Map(scope: favoritesMap) {
// 收藏的标记
}
HStack {
MapScaleView(scope: favoritesMap)
MapCompass(scope: favoritesMap)
}
}
.mapScope(favoritesMap)
}
}如上例所示，我们使用 Namespace 属性包装器生成一个地图标识符，将控件绑定到地图实例。当你需要更改自动可见性配置为始终可见或隐藏时，还可以使用 mapControlVisibility 视图修饰符。
struct MapScopeExample: View {
@Namespace private var favoritesMap
var body: some View {
VStack {
Map(scope: favoritesMap) {
// 收藏的标记
}
HStack {
MapScaleView(scope: favoritesMap)
MapCompass(scope: favoritesMap)
.mapControlVisibility(.hidden)
}
}
.mapScope(favoritesMap)
}
}总结
本文介绍了 SwiftUI 中 MapKit API 的定制功能。首先，通过 mapStyle 视图修饰符，我们学习了如何定制地图的呈现样式，包括 imagery 样式的高程设置。其次，我们了解了预定义和可配置的地图样式，例如 standard 样式允许配置地图的高程、感兴趣点和是否显示交通信息，而 hybrid 样式则允许同时显示影像、道路和道路名称。
我们深入了解了 SwiftUI 中 MapKit 的强大功能，包括定制地图样式、交互方式和控件，为开发者提供了更多灵活性和可定制性的选择。
