Apple Map Snapshotを使ってみた

こんにちは。大山です。
URLごとに異なる座標の地図をOGP画像として表示したいと思い、Apple の Maps Web Snapshots を使ってみたので記事にします。

Maps Web Snapshotsとは

Maps Web Snapshotsは、Apple Mapsのサービス群の一つとして提供される、サーバー向けの静的地図画像HTTP APIです。
緯度経度やピン・図形などのパラメーターをURLクエリとして渡すと、リクエストごとに1枚のPNG/JPEG画像が返ってきます。サーバーサイドから叩いて画像として保存・配信できるので、OGP画像のように「動的な座標を埋め込んだ地図画像」を都度生成したい場面と相性が良いです。

利用にはApple Developer Programのアカウントが必要です。

他のSnapshotサービスと比較

静的地図画像を生成するAPIとしては、GoogleのMaps Static APIやMapboxのStatic Images APIなどがあります。3つを比較してみます（数値はいずれも2026年7月時点の各社公式ページを参照）。

コスト面で見ると、Apple Developer Programに既に登録済みであれば、Apple Snapshotsは日次25,000リクエストの無料枠を追加の課金設定なしにすぐ使い始められます。一方、このAPIのためだけにApple Developer Programへ新規登録する場合は、年会費が発生する点は踏まえておく必要があります。
無料枠を超えるリクエストを送る場合は、公開料金表がないためAppleへの問い合わせが必要です。

地図生成パラメーター

静的地図画像を生成するための主なパラメーターは以下の通りです。

annotations / overlays / imgs は配列を組み立てたうえで、URLエンコードしてクエリパラメーターとして渡す形式になります。

使ってみる

まずはシンプルに、中心座標だけを指定して地図画像を1枚取得してみます。

curl --get "https://snapshot.apple-mapkit.com/api/v1/snapshot" \
  --data-urlencode "center=35.681236,139.767125" \
  --data-urlencode "size=600x400" \
  --data-urlencode "t=standard" \
  --data-urlencode "colorScheme=light" \
  --data-urlencode "lang=ja-JP" \
  --data-urlencode "token=${APPLE_MAPS_JWT}" \
  --output map.png

この curl コマンドを実行すると、指定した座標を中心とする地図画像が map.png として保存されます。

ここに annotations や imgs パラメーターを追加すると、中心にピンを立てたり、独自のアイコン画像をピンとして表示することができます。

拡大率を変える

z パラメーターでズームレベルを指定すると、中心座標を基準にどの程度拡大して表示するかを調整できます。指定できる範囲は 3.0〜20.0 で、値が大きいほど拡大されます。

--data-urlencode "z=16"

z を大きくするほど建物一つひとつが分かる程度まで拡大できますが、その分表示される範囲は狭くなります。逆に小さくすると広いエリアを俯瞰できます。
なお center=auto を指定してピンや図形が収まるように自動調整させる場合や、spn で表示範囲を直接指定した場合は z の値は無視されます。

ピンをたてる

--data-urlencode 'annotations=[
  {
    "point":"35.681236,139.767125",
    "markerStyle":"balloon",
    "color":"black"
  }
]'

ピンの種類はmarkerStyleで変更でき、標準で用意されているものは以下の通りです。

dot	balloon	large

カスタムピンを立てる

annotations の markerStyle を img にすることで、標準のピンではなく任意の画像をピンとして表示できます。

--data-urlencode 'annotations=[
    {
      "point":"35.681236,139.767125",
      "markerStyle":"img",
      "imgIdx": 0
    }
  ]' \
--data-urlencode 'imgs=[
    {
      "url":"https://example.com/assets/map-icon.png",
      "width":100,
      "height":100
    }
  ]' \

オブジェクト（オーバーレイ）を描画する

overlays を使うと、円などの図形を地図上に重ねて描画できます。

--data-urlencode 'overlays=[
  {
    "type":"circle",
    "center":"35.681236,139.767125",
    "radius":300,
    "style":{
      "strokeColor":"0088ff",
      "strokeOpacity":1,
      "lineWidth":4,
      "fillColor":"0088ff",
      "fillOpacity":0.3
    }
  }
]'

まとめ

実際に使ってみて、特に地図をインタラクティブに操作する必要はなく、座標に応じて動的に地図画像を表示したいOGPのような用途と相性が良いと思いました。

Apple Developer Programにすでに登録していれば追加の契約なしにすぐ使えますし、カスタムピンやオーバーレイで見た目も作り込めるので、選択肢の一つとして検討してみてください。