スタティック·イメージ (Static Images)

Mapbox Static Images APIは、Mapbox Studioスタイルで生成するスタンドアロンのスタティック（静的）マップ画像を提供します。マッピングライブラリやAPIを使用せずに、これらの画像をWebおよびモバイル機器に表示することができます。一件、埋め込みマップのように見えますが、インタラクティブ機能やコントロール機能はありません。

• ベクター·レイヤーを含むスタイルの場合、返すスタティックマップは、PNG形式になります。
• ラスタ·レイヤーを含むスタイルの場合、返すスタティックマップは、JPEG形式になります。

Static Images APIリクエストを作成するには、Static Images APIプレイグラウンドを使用し、インタラクティブマップをズームおよびパンします。

Static Images APIの請求方法については、製品別価格ガイドをご覧ください。

スタイルからスタティックマップを取得する方法

/styles/v1/{username}/{style_id}/static/{overlay}/{lon},{lat},{zoom},{bearing},{pitch}|{auto}/{width}x{height}{@2x}

マップの位置は、「auto」 または 5 つの数値 (経度、緯度、ズーム、ベアリング、ピッチ) で表します。最後の 2 つの数値(ベアリングとピッチ)は任意です。ベアリングのみを指定すると、ピッチはデフォルトで0になります。どちらも指定しない場合、どちらもデフォルトで 0 になります。「auto」を指定する場合は、これらの数値を指定しないでください。

次の任意のパラメータを使用して、このエンドポイントからの結果をさらに絞り込むことができます。

リクエスト例: スタイルからスタティックマップを取得する

# Retrieve a map at -122.4241 longitude, 37.78 latitude,
# zoom 14.24, bearing 0, and pitch 60. The map
# will be 600 pixels wide and 600 pixels high
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/-122.4241,37.78,14.25,0,60/600x600?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Retrieve a map at 0 longitude, 10 latitude, zoom 3,
# and bearing 20. Pitch will default to 0.
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/0,10,3,20/600x600?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Retrieve a map at 0 longitude, 0 latitude, zoom 2.
# Bearing and pitch default to 0.
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/0,0,2/600x600?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Querying a style with raster layers returns a JPEG
$ curl "https://api.mapbox.com/styles//mapbox/satellite-/static/0,0,2/600x600?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Retrieve a map with a custom marker overlay
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/url-https%3A%2F%2Fwww.mapbox.com%2Fimg%2Frocket.png(-76.9,38.9)/-76.9,38.9,15/1000x1000?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Retrieve a map with a GeoJSON overlay
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/geojson(%7B%22type%22%3A%22Point%22%2C%22coordinates%22%3A%5B-73.99%2C40.7%5D%7D)/-73.99,40.70,12/500x300?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

# Retrieve a map with two points and a polyline overlay,
# with its center point automatically determined with `auto`
$ curl "https://api.mapbox.com/styles//mapbox/streets-11/static/pin-s-a+9ed4bd(-122.46589,37.77343),pin-s-b+000(-122.42816,37.75965),path-5+f44-0.5(%7DrpeFxbnjVsFwdAvr@cHgFor@jEmAlFmEMwM_FuItCkOi@wc@bg@wBSgM)/auto/500x300?access_token=YOUR_MAPBOX_ACCESS_TOKEN"

応答: スタイルからスタティックマップを取得する

• ベクター·レイヤーを含むスタイルの場合、返されるスタティックマップは、PNG形式になります。
• ラスタ·レイヤーを含むスタイルの場合、返されるスタティックマップは、JPEG形式になります。

オーバーレイのオプション

GeoJSON

geojson({geojson})

マーカー

{name}-{label}+{color}({lon},{lat})

カスタム マーカー

url-{url}({lon},{lat})

Expires およびCache-Controlヘッダーに従って、カスタムマーカーをキャッシュします。カスタムマーカー画像のリクエストが繰り返されないように、少なくともヘッダーの1つを適切な値に設定してください。

パス

path-{strokeWidth}+{strokeColor}-{strokeOpacity}+{fillColor}-{fillOpacity}({polyline})

Static APIでは、pathパラメーターを経て、小数点以下5桁の精度でエンコードされたポリラインを使用することができます。

Static Images API エラー

Static Images APIの制限

• スタティックイメージ API エンドポイントの使用は、ユーザープランに基づいてレート制限されます。デフォルトのレート制限は1分あたり600リクエストです。より高いレート制限が必要な場合は、お問い合わせください。
• この制限を超えると、HTTP 429応答が発生します。レート制限ヘッダーの詳細については、レート制限ヘッダーセクションを参照してください。