<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.9.0 -",
    "tvOS: 9.2.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKit",
  "identifier" : "/documentation/MapKit/MKMapSnapshotter/Options",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "MapKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MKMapSnapshotOptions"
  },
  "title" : "MKMapSnapshotter.Options"
}
-->

# MKMapSnapshotter.Options

The options the snapshotter initializer uses to create a snapshotter to capture map-based imagery.

```
class Options
```

## Overview

After creating and configuring an instance of this class, you pass that instance to an [`MKMapSnapshotter`](/documentation/MapKit/MKMapSnapshotter) object. The snapshotter uses the configuration options to determine which portion of the map to capture, the viewing angle to use for the camera, and the map’s overall appearance.

In macOS 10.14 and later, you can apply a light or dark appearance to your map snapshots by modifying the [`appearance`](/documentation/MapKit/MKMapSnapshotter/Options/appearance) property of your snapshot options. Even if you specify a custom appearance, users can use the Maps app to force all maps to adopt a light appearance.

## Topics

### Configuring the snapshot region

[`region`](/documentation/MapKit/MKMapSnapshotter/Options/region)

The area of the map that you want to capture.

[`mapRect`](/documentation/MapKit/MKMapSnapshotter/Options/mapRect)

The map rectangle that you want to capture.

[`camera`](/documentation/MapKit/MKMapSnapshotter/Options/camera)

The camera to use when taking the map snapshot.

### Configuring the map data

[`preferredConfiguration`](/documentation/MapKit/MKMapSnapshotter/Options/preferredConfiguration)

The map configuration style to use for snapshots.

[`mapType`](/documentation/MapKit/MKMapSnapshotter/Options/mapType)

The map’s visual style.

[`showsBuildings`](/documentation/MapKit/MKMapSnapshotter/Options/showsBuildings)

A Boolean that indicates whether the map displays extruded building information.

[`pointOfInterestFilter`](/documentation/MapKit/MKMapSnapshotter/Options/pointOfInterestFilter)

The filter to use for determining the points of interest that appear in the snapshot.

[`showsPointsOfInterest`](/documentation/MapKit/MKMapSnapshotter/Options/showsPointsOfInterest)

A Boolean value that indicates whether the map displays point-of-interest information.

### Configuring the image output

[`traitCollection`](/documentation/MapKit/MKMapSnapshotter/Options/traitCollection)

Traits that determine the appearance of the map snapshot.

[`size`](/documentation/MapKit/MKMapSnapshotter/Options/size)

The size of the image that you want to create.

[`appearance`](/documentation/MapKit/MKMapSnapshotter/Options/appearance)

The visual style (light or dark) to apply to the map when rendering the snapshot image.

[`scale`](/documentation/MapKit/MKMapSnapshotter/Options/scale)

The scale factor to use when creating the image.

## Relationships

### Conforms To

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`Equatable`](/documentation/Swift/Equatable)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)