ams-cli - SKILL.md Agent Skill

name: ams-cli description: Query Apple Maps Server APIs using the ams CLI. Use when working with geocoding, reverse geocoding, search, directions, or when the user mentions Apple Maps, geolocation, map data, or ams.

Apple Maps Server CLI

Query Apple Maps Server APIs using the ams command-line tool.

Prerequisites

ams --version
export AMS_TOKEN='your-jwt-token'
ams auth status

Authentication

JWT token from Apple Developer Portal
Environment variable: AMS_TOKEN
Or: ams auth set-token YOUR_TOKEN

Geocoding

Forward Geocoding

ams geocode "1 Infinite Loop, Cupertino, CA"
ams geocode --query "Empire State Building" --limit 5

Reverse Geocoding

ams reverse --lat 37.3318 --lon -122.0312
ams reverse --coordinate 37.3318,-122.0312 --language en

Search

ams search --query "coffee shops" --near "San Francisco, CA"
ams search --query "gas stations" --near LAT,LON --radius 5000
ams search --category restaurants --near "Palo Alto" --limit 20

Directions

ams directions --from "San Francisco, CA" --to "San Jose, CA"
ams directions --from LAT,LON --to LAT,LON --mode driving --alternatives
ams directions --from "Current Location" --to "SFO" --avoid tolls

Places & POI

ams places get PLACE_ID
ams places nearby --lat 37.3318 --lon -122.0312 --category hotel
ams places search --query "Apple Park" --detailed

Agent Best Practices

Coordinate format: Use decimal degrees (lat,lon)
Rate limits: Respect Apple Maps Server limits
Language: Use --language for localized results
Units: Default metric; use --imperial for miles/feet