ams-cli について
`ams` コマンドラインツールで Apple Maps Server API を照会するスキルです。ジオコーディング、場所の検索、経路取得に対応し、Apple Maps のデータを使うワークフローに適しています。
主な機能
- 01ジオコーディングと逆ジオコーディング
- 02周辺の場所を検索
- 03場所の詳細を取得
- 04代替ルートを含む経路検索
- 05JWT 認証の設定
活用シーン
- 01住所の座標を調べる
- 02近くの飲食店やサービスを検索
- 03場所 ID から詳細を確認
- 042地点間の経路を取得
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dl-alexandre/ skills --skill ams-cliインストール後、Claude Code で/ams-cliを入力して読み込まれたか確認します。
詳細
Apple Maps Server CLI
ams コマンドラインツールを使用して Apple Maps Server API にクエリを送信します。
前提条件
ams --version
export AMS_TOKEN='your-jwt-token'
ams auth status
認証
- Apple Developer Portal の JWT トークン
- 環境変数:
AMS_TOKEN - または:
ams auth set-token YOUR_TOKEN
ジオコーディング
フォワードジオコーディング
ams geocode "1 Infinite Loop, Cupertino, CA"
ams geocode --query "Empire State Building" --limit 5
リバースジオコーディング
ams reverse --lat 37.3318 --lon -122.0312
ams reverse --coordinate 37.3318,-122.0312 --language en
検索
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
ルート案内
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
場所と POI
ams places get PLACE_ID
ams places nearby --lat 37.3318 --lon -122.0312 --category hotel
ams places search --query "Apple Park" --detailed
エージェントのベストプラクティス
- 座標形式:10 進数の度数(lat,lon)を使用します
- レート制限:Apple Maps Server の制限を守ります
- 言語:ローカライズされた結果を得るには
--languageを使用します - 単位:デフォルトはメートル法です。マイル/フィートを使用するには
--imperialを指定します
コメント
Markdown 対応