<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/app-schema-domain-maps",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Maps"
}
-->

# Maps

Make your navigation app’s actions available to Apple Intelligence and Siri by adopting schemas for common navigation actions.

## Discussion

The `.maps` domain defines app schemas that provide a
structured representation for common navigation actions and content.
Apply schemas in the `.maps` domain to make your app’s navigation functionality available to Apple Intelligence and Siri.
Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across navigation apps.
For example, a person can start a route on different apps that support the
[`startNavigation`](/documentation/AppIntents/AppSchema/MapsIntent/startNavigation) schema with the same phrases.

The following table maps example phrases that apply to each schema:

|Maps intent schemas                                                                                   |Example phrases                                         |
|------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/startNavigation``          |“Navigate to work.” or “Take me home.”                  |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/updateNavigationWaypoints``|“Add a stop.” or “Update my route to include my office.”|
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/stopNavigation``           |“Stop navigation.” or “Cancel directions.”              |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/shareETA``                 |“Share my ETA.” or “Send my ETA to Anne.”               |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/stopShareETA``             |“Stop sharing my ETA.”                                  |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/MapsIntent/reportIncident``           |“Report an accident.” or “There’s a crash ahead.”       |

> Tip: Xcode generates a template implementation when you type `maps_` and select a schema from the suggestions list.

For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai).

## Topics

### Actions

[`var reportIncident: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/reportIncident)

An intent schema that reports a traffic incident on the route.

[`var shareETA: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/shareETA)

An intent schema that shares ETA to a contact while navigating.

[`var startNavigation: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/startNavigation)

An intent schema that starts navigation.

[`var stopNavigation: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/stopNavigation)

An intent schema that ends navigation.

[`var stopShareETA: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/stopShareETA)

An intent schema that stops sharing ETA.

[`var updateNavigationWaypoints: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/MapsIntent/updateNavigationWaypoints)

An intent schema that updates the list of waypoints for a navigation session.

[`protocol MapsIntent`](/documentation/AppIntents/AppSchema/MapsIntent)

Identifies intent schemas in the maps domain.

### Content and parameter types

[`var currentLocation: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/currentLocation)

An entity schema for a current location.

[`var navigationSession: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/navigationSession)

An entity schema for a navigation session.

[`var operatingHours: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/operatingHours)

An entity schema for an operating hours.

[`var operatingTimeRange: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/operatingTimeRange)

An entity schema for an operating time range.

[`var place: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/place)

An entity schema for a place.

[`var rating: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/MapsEntity/rating)

An entity schema for a rating.

[`protocol MapsEntity`](/documentation/AppIntents/AppSchema/MapsEntity)

Identifies entity schemas in the maps domain.

### Types for static parameters

[`var amenity: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/amenity)

An enum schema for an amenity parameter.

[`var incident: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/incident)

An enum schema for an incident parameter.

[`var navigationPreferences: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/navigationPreferences)

An enum schema for a navigation preferences parameter.

[`var operatingStatus: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/operatingStatus)

An enum schema for an operating status parameter.

[`var priceRange: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/priceRange)

An enum schema for a price range parameter.

[`var ratingDescriptor: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/ratingDescriptor)

An enum schema for a rating descriptor parameter.

[`var transportType: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/MapsEnum/transportType)

An enum schema for a transport type parameter.

[`protocol MapsEnum`](/documentation/AppIntents/AppSchema/MapsEnum)

Identifies enum schemas in the maps domain.



---

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)