Connect Apple Maps to Your AI Agent

Provide a location and destination criteria so AI can organize place details and travel estimates for your decision.

9 tools Custom credential

Try a Apple Maps Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Apple Maps

Compare Nearby Places

Search a location and read selected place details for a shortlist.

/oo Apple Maps: Search Apple Maps for [place category] near [coordinates or region]. Read details for [number] matching places and list addresses, contact details, and source IDs, marking missing information.

Compare Route Options

Read route alternatives and compare distance, time, and toll information.

/oo Apple Maps: Compare Apple Maps [driving, walking, or cycling] routes from [origin] to [destination], departing [date and time with timezone]. Request alternatives and list distance, estimated time, and any toll information.

Compare Destination Travel Times

Resolve addresses and estimate travel to several candidate destinations.

/oo Apple Maps: Resolve [origin address] and these destinations [up to 10 addresses] with Apple Maps. Compare [travel mode] ETAs departing [date and time with timezone], checking ambiguous matches before estimating.

Start Working with Apple Maps

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Apple Maps

    Connect an Apple Developer Team ID, Maps-enabled Key ID, and .p8 private key.

    Connect Apple Maps →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An Apple Developer key configured for MapKit JS and associated with a Maps ID.
  • Confirm ambiguous addresses and place matches. Travel times are estimates and depend on the requested time and mode.

Apple Maps Tools

Apple Maps supplies place records, geocoding, directions, and travel estimates. Route comparisons use your chosen travel mode and departure or arrival time.

Places and Address Matching

Search places, resolve addresses or coordinates, and read place details.

Routes and Travel Estimates

Read route options and estimate travel time to up to ten destinations.

9 tools

Geocode Address

Convert an address into coordinates with Apple Maps. Returns the places Apple matched to the address with their coordinate, map region and structured address. Pass limitToCountries, searchLocation, searchRegion or userLocation to steer an ambiguous address toward the right area.

apple_maps.geocode_address

Reverse Geocode

Convert a latitude and longitude into the addresses at that point with Apple Maps.

apple_maps.reverse_geocode

Search Places

Search Apple Maps for places and points of interest by name, address or category. Filter by point of interest category, address category, result type and country, bias the search with a location or region, and page through large result sets with enablePagination and pageToken.

apple_maps.search_places

Autocomplete Search

Get autocomplete suggestions for partial search text, such as a place name or address a user is still typing, with the same category, country, result type and location filters as search_places. Each suggestion carries display lines and, when available, a coordinate and structured address. Its completionUrl is a relative /v1/search URL that can be requested through the generic proxy to fetch the full place details.

apple_maps.autocomplete_search

Get Place

Get one place by its Apple Maps Place ID.

apple_maps.get_place

Get Places

Get several places at once by their Apple Maps Place IDs. IDs Apple cannot resolve are listed in errors instead of failing the whole call.

apple_maps.get_places

Get Alternate Place Ids

Get the alternate Place IDs of one or more Apple Maps Place IDs. IDs Apple cannot resolve are listed in errors instead of failing the whole call.

apple_maps.get_alternate_place_ids

Get Directions

Get driving, walking or cycling directions between two places with Apple Maps. Returns the routes with their distance, duration and toll information, and the steps they reference by index. Step paths, the polyline of every step, can be large, so they are only returned when includeStepPaths is true.

apple_maps.get_directions

Get Etas

Estimate the travel time and distance from one origin to up to 10 destinations with Apple Maps, by car, public transit, on foot or by bicycle.

apple_maps.get_etas

Frequently Asked Questions

How do I avoid a wrong place match?

Include the country and region or supply coordinates. Ask the assistant to show ambiguous matches before retrieving directions or travel estimates.

Does requesting toll avoidance guarantee a toll-free route?

No. Apple may still return a toll route if no reasonable alternative exists. Check each route’s toll field and keep missing toll information explicit.

Are all travel modes available for detailed directions?

Directions support driving, walking, and cycling. ETA requests also support transit; a transit estimate is not a detailed transit route.

Connect Apple Maps

About Apple Maps ↗