Static Maps

Mapbox Static Mapsは、GLベースの地図スタイルの静止画像をPNGまたはJPEGファイルとして生成するHTTP APIとクライアントライブラリのコレクションです。

Static Mapsは、2つのHTTP APIで構成されています。

• Mapbox Static Images API: は、最大1280x1280ピクセルのMapbox Studioスタイルから生成されたスタンドアロンの静止地図画像を提供します。これらの画像は、マッピングライブラリやAPIの助けを借りずに、Webおよびモバイルデバイスに表示できます。埋め込み地図のように見えますが、インタラクティブ性やコントロールはありません。ベクターレイヤーを含むスタイルでは、返される静止地図はPNGになり、ラスターレイヤーを含むスタイルでは、返される静止地図はJPEGになります。
• Mapbox Static Tiles API: は、Mapbox Studioスタイルから生成されたラスタタイルを提供します。ラスタタイルは、Mapbox.jsやLeafletなどの従来のWebマッピングライブラリで使用して、インタラクティブなスリッピーマップを作成できます。返されるラスタタイルはJPEGになり、デフォルトで512x512ピクセルになります。

および3つのクライアントライブラリ：

• Mapbox.js: マッピングライブラリ Leaflet 用のプラグインであり、Static Tiles API への JavaScript ラッパーです。このライブラリは、単純なデータオーバーレイを持つラスタベースのスリッピーマップを作成するために使用されます。
• MapboxStatic.swift: Static Images API への Swift ラッパーです。このライブラリは、Swift ベースの iOS アプリケーションでスタンドアロンの地図画像とデータオーバーレイを作成するために使用されます。
• The Mapbox Java SDK: Static Images API を含む、多くの Mapbox API への Java ラッパーです。このライブラリは、Java ベースの Android アプリケーションでスタンドアロンの地図画像とデータオーバーレイを作成するために使用されます。

Static Mapsの主な価値提案は、パフォーマンスとシンプルさにあります。Static Mapsを使用すると、非常に少ないコード行で、多くの場合HTMLのimageタグだけで、フル機能を備えた地図を作成できます。つまり、複雑なマッピングライブラリやSDKを学習、ロード、または使用する必要はありません。

Static Mapsは、インタラクティブな地図を統合できないアプリケーションやUIコンテキストを含め、画像を表示できる場所であればどこにでも表示できます。たとえば、メール、アプリの通知、Webおよび印刷物向けのニュース記事、低電力デバイスなどです。

Static Mapsは、さまざまなユースケースで使用できる画像です。

• 配達状況の追跡：荷物がどこにあるかという地理的にコンテキスト化された情報を含む配達状況のアップデートをユーザーに送信します。
• オンライン領収書（ライドシェア、オンデマンドデリバリー、Eコマースなど）：購入がどこで行われたかの正確な概要をユーザーに提供することで、ユーザーとの信頼関係を構築します。‍
• モバイル通知：状況に応じてパーソナライズされた通知を作成します。カスタマイズされた地図スタイルと組み合わせることで、通知は、通知の海に埋もれてしまいがちな1行のテキストから、ユーザーにクリックを促す本質的に関連性の高い画像に変わります。‍
• フィットネスアクティビティフィード：テキストベースのニュースフィードを、ユーザーのアクションの概要を示す地図を含む動的なアクティビティフィードに変換し、他のユーザーのアクティブな行動を促します。‍
• ソーシャルメディアのプロフィール地図：ユーザーのプロフィールページでStatic Mapsを使用して、ユーザーに関するコンテキスト情報を提供し、ユーザー同士のエンゲージメント、コミュニケーション、インタラクションを促進します‍
• Webおよび印刷物向けのニュース地図：Static Mapsを使用して、Webと印刷物の両方で使用できる地図を含むニュース記事を作成します。‍
• ‍Web地図の体感パフォーマンスを向上させる：GL地図の初期化を待機している間、Static Mapsを使用して静的なプレースホルダーを生成します。これにより、GL地図のロード中にユーザーに何かをすぐに表示できます。例はこちらをご覧ください。‍
• WebGLをサポートしていないブラウザのフォールバック：Static Mapsを使用して、WebGLをサポートしていないブラウザでユーザーが地図にアクセスした場合に、一貫性のあるフォールバックエクスペリエンスを提供します。方法については、こちらをご覧ください。

Static Mapsは固定されており、ユーザーの操作やリアルタイムデータに基づいて変化しません。通常、紙に印刷されたり、アプリやWebサイトで画像として表示されます。Dynamic Mapsはインタラクティブな地図であり、ユーザーが操作およびカスタマイズでき、リアルタイムデータフィードを組み込んで、交通状況や気象条件などを表示できます。

Mapbox Static Mapsの各コンポーネントのドキュメントを以下で参照できます。

• HTTP: Static Images API、Static Tiles API
• JavaScript：Mapbox.js
• iOS：MapboxStatic.swift‍
• Android：Mapbox Java SDK

Mapbox GL JS または Mapbox Mobile Maps SDK の代わりに、いつ Static Maps を使用する必要がありますか？

一般に、GLよりもStatic Mapsを使用する主な理由はパフォーマンスです。具体的には、Static Mapsは、GLベースのスリッピーマップの初期レンダリングパフォーマンスの向上、同じページ上での複数のGLコンテキストの表示パフォーマンスの向上、および/または単純なデータオーバーレイを使用した小さな地図の表示に役立ちます。複数のGL地図、または1つのGL地図をロードするだけでもCPU/GPUからの処理が必要になるため、Static Mapsを使用すると、アプリケーションのネットワーク/HTTPアクティビティが増加するだけで済むため、これらの状況ではStatic Mapsの方がパフォーマンスが向上する可能性があります。

さらに、Static Mapsを使用して、GLをサポートしていないブラウザおよびデバイスにフォールバック用のスリッピーマップを提供できます。

クライアント側のGLがStatic Mapsよりも有利なユースケースについては、このFAQの「制限事項」セクションで説明されています。

‍

iOSおよびAndroid向けのStatic MapsとMapbox Map Snapshotterの違いは何ですか？

Mapbox Static MapsとMapbox Map Snapshotterはどちらも、モバイルアプリケーションで使用するためにGLベースの地図スタイルの静止画像を生成するために使用できます。ただし、Static Mapsは、クライアントに画像を配信する前にサーバー側で画像を生成しますが、Mapbox Snapshotterは、Mapbox Maps SDKを初期化し、必要な地図スタイルとタイルセットをリクエストした後、クライアント側で画像を生成します。

‍

Static MapsとMap Snapshotterは、どのような場合に使用すべきですか？

モバイルアプリケーションにすでにロードされているGLベースのスタイルから静止画像を生成したい場合は、必要なリソースがすべてローカルにあるため、Map Snapshotterを使用してクライアント側で静止画像を生成する方がパフォーマンスが高い可能性があります。

Mapbox Maps SDKを使用しないモバイルアプリケーションの一部で、またはGLベースのスタイルがまだロードされていない場所で静止画像を生成したい場合は、Static Mapsを使用してサーバー側で静止画像を生成する方がパフォーマンスが高い可能性があります。これは、Static Mapsは、地図を生成する前にGLなどのマッピングライブラリや他のクライアント側SDKをロードする必要がなく、Static Mapsは地図のレンダリングに必要なすべてのリソースへの最適化された低レイテンシのアクセスを備えているためです。Static Mapsは、リソースを取得するためにパブリックインターネットを経由する必要があるモバイルクライアントとは異なり、リソースを取得するために常にAWSネットワーク内に留まることができます。

‍

Static Mapsは、どのような種類の地図スタイルと互換性がありますか？

Static Mapsを使用すると、Mapbox GL Style Specificationに従う任意の地図スタイルの静止画像を生成できます。これには、Mapbox Studioで作成されたスタイル、またはMapbox Styles API v1で直接作成されたスタイルが含まれます。

‍

地図スタイルに加えた変更がStatic Mapsに反映されるまで、どのくらいの時間がかかりますか？

Static Mapsのデフォルトのキャッシュ動作に基づき、地図の変更が反映されるまでに最大12時間かかる場合があります。

‍

Static Mapsでは、GL JSまたはMapbox Studioのすべてのスタイリング機能が利用できますか？

最初はそうではありません。GL JSとMapbox Studio、Static Mapsで利用できるスタイリングのパリティを目指していますが、GL JSまたはStudioで利用できる新しいスタイリング機能がStatic Mapsでも利用できるようになるまでには時間がかかる場合があります。Static Mapsに追加してほしい特定のスタイリング機能がある場合は、お知らせください。

Mapbox Static Mapsは、他の静止地図プロバイダーと比べてどうですか？

パフォーマンス

Mapboxは、さまざまな地域やユースケースにおいて、他の静止地図プロバイダーよりも一貫してパフォーマンスが高くなっています。

オーバーレイ: 100個のマーカーと100ポイントのパス

画像サイズ: 小=180x144、中=1280x1024

解像度: 通常、@2x

地域: ロサンゼルス、ロンドン、フランクフルト、東京、香港

さまざまなユースケースや地域において、Mapboxの静止画像の平均ロード時間は、画像がすでにキャッシュされているかどうかによって100〜200msと425msの間です。

‍

オーバーレイのサポート

Mapboxは、マーカー、塗りつぶしのあるパス、および他のプロバイダーとは異なり、静止地図上のGeoJSONオーバーレイをサポートしています。これにより、静止地図にオーバーレイを追加する際のカスタマイズと柔軟性が大幅に向上します。円は、拡張機能from Leafletを介してStatic Tilesのオーバーレイとして追加することもできます。

‍

動的地図スタイル

リクエスト時に静的地図のスタイルを変更できる静的地図プロバイダーはGoogleだけですが、その機能は地図フィーチャを非表示にするか、その色を変更することに限定されています。 Static Images APIのスタイルパラメーターと同じレベルの静的地図のカスタマイズを提供する静的地図プロバイダーは他にありません。

addlayer: このパラメーターを使用して、新しいスタイルレイヤーを地図に追加し、既存のレイヤーのスタイルを変更します。この機能を使用すると、大統領選挙の結果や洪水地帯への近さなど、共有属性に基づいて、地図内のすべての州の色を変更したり、すべての建物を押し出したりすることができます。

setfilter: このパラメーターは、Mapboxの式構文に準拠する配列値を受け入れます。このパラメーターを使用して、既存のスタイルレイヤーからフィーチャを除外します。たとえば、ランニング、ハイキング、またはマウンテンバイクのコースを探すのに役立つアプリを構築している場合、ユーザーが関心のあるアクティビティのタイプに必要なコースを除く、地図からすべての道路とコースを除外できます。

‍

画像の詳細

Mapboxは、最大@2xの解像度、および最大ピクセル長1280x1280で、PNGおよびJPEG画像形式のサポートを提供します。

‍

Static Mapsの料金体系について教えてください。

Static Mapsの料金は、Static Images APIとStatic Tiles APIの個々のAPIリクエストごとに請求されます。Static Images APIは、月間50,000件のリクエストまでは無料で、その後は1,000件あたり1.00ドルからとなり、月間500,000件、100万件、500万件を超える使用量に対して段階的なボリュームディスカウントが適用されます。

Static Tiles APIは、月間20万リクエストまでは無料で、その後は1,000リクエストあたり0.50ドルからとなり、月間200万、400万、2,000万リクエストを超えると、段階的なボリュームベースの割引が適用されます。

料金に関する詳細は、https://www.mapbox.com/pricing/をご覧ください。

‍

リクエストする静止画像のピクセルサイズは、リクエストごとに支払う料金に影響しますか？

いいえ。Static Images APIとStatic Tiles APIの両方の価格は、リクエストの寸法に依存しません。

Static Mapsのサービス制限は何ですか？

Static Images APIとStatic Tiles APIの使用はレート制限されており、デフォルトのレート制限はそれぞれ1分あたり1,200リクエスト、1分あたり5,000リクエストです。これらの制限を超えると、HTTP 429応答が返されます。ただし、より高いレート制限が必要な場合は、お問い合わせください。

‍

Static Mapsの機能に関する制限は何ですか？

• 機能のインタラクティブ性： Static Mapsは画像ファイルを生成するため、クライアントのGPUを使用してレンダリング機能を強化できるベクターベースのGLマップのような、フィーチャのインタラクティブ性は本質的にありません。
• 動的なクライアントサイドのスタイル変更とデータ視覚化： Static Mapsでスタイルパラメーターを使用すると、リクエスト時にリクエストされたマップスタイルを変更できますが、大規模なクライアントサイドのスタイル変更とデータ操作は、クライアント側のRuntime StylingとMapbox GLの式を使用する方が効率的です。
• 回転/ピッチ角のあるSlippy Maps: Static Tiles APIは、回転またはピッチ角のあるビューをサポートしていません（たとえば、ターンバイターンナビゲーションで使用されているように）。ただし、Static Images APIは、地図の回転とピッチ角をサポートしています。
• スムーズなズーミング：Static Mapsは、各整数ズームレベルで静止画像を生成するだけです。つまり、Static Tiles APIで作成されたスリッピーマップを拡大または縮小すると、ズームレベル間で「ジャンプ」が発生する可能性があります。ベクターベースのスリッピーマップは、整数以外のズームレベルで 「スムーズなズーミング」を提供するため、この「ジャンプ」は明らかではありません。
• Cut-off labels: Because the Static Tiles API renders images for its slippy maps one tile at a time as opposed to continuously like with a vector-based map, there is a small probability that any map labels placed at or near tile boundaries will be partially cut-off. Use of GL features that enable dynamic, variable or otherwise non-deterministic label placement, or increased label density can both increase the rate of cut-off labels with the Static Tiles API. If using Static Maps with one of Mapbox’s Core Styles, then you can expect <2% of your map labels to be cut-off in any region. If using Static Maps with a custom style, then you can expect <5% of your map labels to be cut-off in any region.
• URLの長さ制限：Static Mapsの機能（スタイリング、方向付け、マップへのオーバーレイの追加など）の多くは、GET HTTPリクエストを介して利用できます。つまり、Static Mapsのすべての機能は、8,192バイトのURLの長さ制限によって制限されます。

‍

Static Mapsのユースケースに基づく制限は何ですか？

• プロキシと再配布   
  Static Mapsへのすべてのリクエストは、エンドユーザーデバイスによって生成される必要があります。サーバーによってリクエストが生成された場合、結果の画像を後でエンドユーザーデバイスに再配布することはできません。
  

• キャッシュ 
  Static Images APIとStatic Tiles APIから返される静止画像は、クライアントデバイス上で最大30日間キャッシュできます。ただし、30日を超えて静止画像をキャッシュする必要がある場合は、お問い合わせください。
  

• 印刷 
  静止画像の印刷は、個人的な非商用利用のみ許可されています。mapbox-streets-v8タイルセットを組み込んだマップスタイルを使用する場合、日本を含む静止画像の印刷は許可されていません。ただし、日本を含む静止画像の印刷、および/または商用利用が必要な場合は、お問い合わせください。
  

Static Mapsの今後の機能にはどのようなものがありますか？

現在、2020年に向けて、以下の機能に対するお客様からの要望を評価しています。

• Static Tiles API の Map Loads 価格：Mapbox.js を使用する場合、タイルリクエストごとではなく、マップロードごとに Static Tiles API の料金をお支払いいただきます。
• @4x解像度のサポート： 高解像度ディスプレイ向けに、最大@4xのスケールファクターで静止画像をリクエストできます。
• カスタムテキストマーカー： リクエストする静止画像に、カスタムテキストベースのマーカーを追加する機能です。‍
• 3D静止画像のサポート： 3Dスタイルルールを含むスタイルに対して、静止画像をリクエストできます。

‍

これらの機能にご興味をお持ちいただけましたら、ぜひお知らせください。

Static Image Playgroundは、Static Images APIに対するリクエストをプロトタイプするために使用できるインタラクティブなWebアプリケーションです。SDKをインストールしたり、追加のコードを記述したりせずに、Static Images APIに対する有効なリクエストを作成できます。

はい。Static Image Playgroundには、Static Images APIの考えられるすべての機能のサポートが含まれています。これには以下が含まれます。

• Mapbox Studioで作成されたカスタムスタイルで画像リクエストを構築します。
• Static Imageリクエストに、複数のマーカー、パス、およびGeoJSONオーバーレイを追加します。
• オーバーレイデータとともに使用した場合の「自動」ポジショニングの結果を確認します。
• 中心座標ペアではなく、バウンディングボックスに基づいて地図画像を生成します。
• 画像全体または画像の一部の辺に対して、地図画像の視覚的なパディングを調整します。

ドキュメントにあるように、有効なオーバーレイは、Geojson、マーカー、またはエンコードされたパスです。オーバーレイ入力エントリに無効なエントリを入力すると、エラーが表示されます。

Static Image Playgroundは、Static Images APIリクエストをプロトタイプするための理想的なツールです。Static Images APIが持つすべての機能と、各機能の動作を学ぶために使用してください。APIの機能をより深く理解しようとしている初心者にも、リクエストを視覚的にデバッグする必要がある経験豊富な開発者にも最適です。

Static Image Playgroundは、最新のWebブラウザを搭載したあらゆるデバイスからアクセスできるレスポンシブWebアプリケーションです。デスクトップ、タブレット、またはモバイルデバイスからStatic Images APIリクエストをプロトタイプできます。

Static Image Playgroundアプリケーション内で行われたリクエストは、お客様のアカウントに関連付けられたStatic Images APIの使用量を生成しません。ただし、リクエストURIを構築した後、このURIをアプリケーションに組み込んだり、直接リクエストを実行したりすると、これらのリクエストは課金対象の使用量を生成します。

Static Image Playgroundは、現時点ではそのインターフェースへのプログラムによるアクセスを許可しておらず、Static Images APIリクエストのプログラムによる生成にも適していません。アプリケーションに直接組み込むことができるツールをお探しの場合は、mapbox-sdk.jsまたはそのいずれかの代替手段を強くお勧めします。