静的地図

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

Static Mapsは2つのHTTP APIで構成されている：

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

と3つのクライアント・ライブラリ：

• Mapbox.js: マッピングライブラリLeafletのプラグインで、Static Tiles API の JavaScript ラッパーです。このライブラリは、シンプルなデータを重ね合わせたラスターベースのスリッピーマップを作成するために使用されます。
• MapboxStatic.swiftStatic Images API の Swift ラッパーです。このライブラリは Swift ベースの iOS アプリケーションでスタンドアローンの地図画像やデータオーバーレイを作成するために使用します。
• Mapbox Java SDKStatic Images API を含む多くのMapbox API の Java ラッパーです。このライブラリは、JavaベースのAndroidアプリケーションでスタンドアロンの地図画像やデータオーバーレイを作成するために使用されます。

スタティック・マップの主な価値提案は、パフォーマンスとシンプルさです。Static Mapsを使用すると、多くのコードを記述することなく、多くの場合HTMLの画像タグだけで完全な機能を備えたマップを作成することができます。つまり、複雑なマッピングライブラリやSDKを学んだり、ロードしたり、使用したりする必要がありません。

スタティック・マップは、インタラクティブ・マップを統合できないアプリケーションやUIのコンテキストを含め、画像を表示できる場所であればどこにでも表示できます。例えば、電子メール、アプリの通知、ウェブと印刷物の両方の記事、低電力デバイスなどです。

スタティック・マップは、さまざまなユースケースで使用できる画像である：

• 配送追跡： 荷物がどこにあるかという地理的な情報を含む配送の最新情報をユーザーに送信します。
• オンライン・レシート（ライドシェア、オンデマンド・デリバリー、Eコマースなど）： 購入した商品の正確な購入場所を知らせることで、ユーザーとの信頼関係を築くことができます。
• モバイル通知：文脈に合わせてパーソナライズされた通知を作成します。 カスタマイズされたマップスタイルと組み合わせることで、通知は、通知の海の中で迷子になりそうな1行のテキストから、ユーザーのクリックを促す本質的に関連性のある画像に変わります。
• フィットネス・アクティビティ・フィード： テキストベースのニュースフィードを、マップを使ったダイナミックなアクティビティフィードに変換。
• ソーシャルメディア・プロファイル・マップ： ユーザーのプロフィール・ページにスタティック・マップを使用し、ユーザーに関する文脈情報を提供することで、ユーザーのさらなる関与、コミュニケーション、相互作用を促す。
• ウェブと印刷物用のニュースマップ： スタティックマップを使用して、ウェブと印刷物の両方で使用できるマップ付きのニュース記事を作成します。
• ウェブマップの知覚パフォーマンスの向上:GLマップの初期化を待つ間、静的プレースホルダーを生成するために静的マップを使用します。これにより、GLマップがロードされる間、すぐにユーザーに何かを見せることができます。こちらの例を参照してください。
• WebGL をサポートしていないブラウザのためのフォールバック: 静的マップを使用して、ユーザーが WebGL をサポートしていないブラウザでマップにアクセスしたときに、一貫したフォールバック体験を提供します。その方法はこちらをご覧ください。

静的地図は固定されており、ユーザーとの対話やリアルタイムのデータに基づいて変化することはない。通常、紙に印刷されるか、アプリやウェブサイトに画像として表示される。ダイナミックマップは、ユーザーが操作したりカスタマイズしたりできるインタラクティブな地図で、リアルタイムのデータフィードを組み込んで交通パターンや天候などを表示することができる。

Mapbox Static Mapsの各コンポーネントのドキュメントは以下からご覧いただけます：

• HTTP:静的画像API、静的タイルAPI
• JavaScript:Mapbox.js
• iOS：MapboxStatic.swift↪Cf_200D
• アンドロイドMapbox Java SDK

Mapbox GL JSやMapbox Mobile Maps SDKsの代わりに、どのような場合にStatic Mapsを使うべきですか？

一般的に、GLよりもスタティックマップを使用する主な理由はパフォーマンスです。特に、スタティックマップは、GLベースのスリッピーなマップの初期レンダリングパフォーマンスを改善したり、同じページに複数のGLコンテキストを表示するパフォーマンスを改善したり、単純なデータオーバーレイで小さなマップを表示したりするのに役立ちます。なぜなら、複数の、あるいはたった一つのGLマップをロードするには、CPU/GPUの作業が必要だからです。

さらに、スタティック・マップを使えば、GLをサポートしていないブラウザやデバイスのために、フォールバックのスリッピー・マップを提供することができます。

クライアントサイドGLがスタティックマップよりも使用するのに有利なユースケースは、このFAQの制限事項のセクションで説明されています。

‍

スタティック・マップとiOS/Android用Mapbox マップ・スナップショッターの違いは何ですか？

Mapbox Static MapsとMapbox Map Snapshotterの両方を使用して、モバイルアプリケーションで使用するGLベースのマップスタイルの静的画像を生成できます。ただし、Static Mapsは画像をクライアントに配信する前にサーバー側で画像を生成し、Mapbox SnapshotterはMapbox Maps SDKを初期化し、必要なマップスタイルとタイルセットを要求した後にクライアント側で画像を生成します。

‍

どのような場合にスタティック・マップとマップ・スナップショッターを使い分ける必要がありますか？

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

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 に反映されるまでにどのくらい時間がかかりますか?

スタティック マップのデフォルトのキャッシュ動作に基づき、マップの変更が反映されるまでに最大 12 時間かかる場合があります。

‍

GL JSやMapbox Studioのスタイリング機能は、すべてスタティックマップで利用できますか？

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

Mapbox Static Mapsと他の静的地図プロバイダーとの比較は？

パフォーマンス

Mapbox は、様々な地域やユースケースにおいて、他の静的マッププロバイダよりも一貫して高いパフォーマンスを発揮する。

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

画像サイズSmall=180x144, Medium=1280x1024

解像度 ノーマル、@2倍

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

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

‍

オーバーレイ・サポート

Mapbox は、マーカー、塗りつぶし付きパスをサポートしており、他のプロバイダーとは異なり、静的地図上にGeoJSONオーバーレイを表示します。これにより、静的マップにオーバーレイを追加する際に、より多くのカスタマイズと柔軟性が可能になります。また、Leafletの拡張機能により、静的タイルのオーバーレイとして円を追加することもできます。

‍

ダイナミックマップスタイル

Google はリクエスト時に静的マップのスタイルを変更できる唯一の静的マッププロバイダですが、その機能はマップの特徴を隠すか色を変更するかに限られています。Static Images APIでStyle Parametersと 同じレベルの静的マップのカスタマイズを提供する静的マッププロバイダは他にありません。

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

setfilter:このパラメータには、Mapbox の式構文に従った配列値を指定します。このパラメータを使用して、既存のスタイルレイヤーからフィーチャーをフィルタリングします。たとえば、ランニングやハイキング、マウンテンバイクのコースを検索するためのアプリを作成している場合、ユーザーが興味のあるアクティビティのタイプに必要なパスを除いて、すべての道路やパスをマップからフィルタリングできます。

‍

画像詳細

Mapbox 最大解像度2倍、最大ピクセル長1280x1280のPNGおよびJPEG画像フォーマットをサポート。

‍

スタティック・マップにはどのような価格設定がありますか？

Static Mapsは、Static ImagesおよびStatic Tiles APIのAPIリクエストごとに課金されます。Static Images APIは、月間50Kリクエストまでは無料で、その後1,000リクエストごとに1ドルからとなり、月間500K、1M、5Mリクエストを超えるとボリュームベースの割引が適用されます。

Static Tiles APIは、月間20万リクエストまでは無料で、その後は1000リクエストごとに0.50ドルから、月間200万、400万、20000リクエストを超えると段階的にボリュームベースのディスカウントが適用される。

https://www.mapbox.com/pricing/ で価格情報をご覧いただけます。

‍

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

Static Images APIとStatic Tiles APIの価格は、リクエストのサイズには関係ありません。

スタティック・マップのサービス制限は？

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

‍

スタティック・マップの機能的な制限は何ですか？

• フィーチャーのインタラクティブ性：Static Mapsは画像ファイルを生成するため、レンダリングされたマップには、クライアントのGPUを使用してレンダリング機能を強化できるベクターベースのGLマップと同じタイプのフィーチャー・インタラクティビティがありません。
• 動的なクライアントサイドのスタイル変更とデータ可視化：スタティック・マップでスタイル・パラメータを使用すると、リクエスト時に要求されたマップ・スタイルを変更できますが、大規模なクライアント側のスタイル変更とデータ操作は、クライアント上のランタイム・スタイリングとMapbox GL式を使用した方が効率的です。
• 回転/ピッチビューのスリッピーマップ：Static Tiles APIは回転やピッチビュー（ターンバイターン・ナビゲーションで使用されるような）をサポートしていません。しかし、Static Images APIは地図の回転やピッチをサポートしています。
• スムーズなズーム： つまり、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 長さの制限: スタイリング、オリエンテーション、マップへのオーバーレイの追加など、スタティックマップの機能の多くは、GET HTTP リクエストで利用できます。これは、スタティックマップのすべての機能が、8,192バイトのURL長制限によって制限されていることを意味します。

‍

スタティック・マップのユースケースに基づく制限とは？

• プロキシと再配布
  スタティック・マップへのリクエストはすべて、エンドユーザーデバイスによって生成されなければなりません。サーバから生成されたリクエストは、エンドユーザデバイスに再配布することはできません。
  

• キャッシュ
  Static Images API および Static Tiles API が返す静的画像は、最大30日間までしかクライアント端末にキャッシュできません。ただし、30日間を超える静的画像のキャッシュが必要な場合は、お問い合わせください。
  

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

スタティック・マップの今後の機能は？

我々は現在、2020年における以下の機能に対する顧客の需要を評価している：

• Static Tiles APIのマップロード価格： Mapbox.jsを使用する場合、タイルリクエストごとに支払うのではなく、マップロードごとにStatic TIles APIの料金を支払います。
• 4倍の解像度をサポート：高解像度ディスプレイ用に、最大4倍の拡大率で静止画像をリクエストできます。
• カスタムテキストマーカー：リクエストする静止画像に、カスタムテキストベースのマーカーを追加する機能。
• 3D静止画像のサポート：3Dスタイルルールを含むスタイルに静止画像を要求する

‍

もし、これらの機能に興味をお持ちでしたら、ぜひお知らせください！

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

静的画像プレイグラウンドは、静的画像APIのすべての機能をサポートしています。これらには以下が含まれます：

• Mapbox Studioで作成したカスタムスタイルでイメージリクエストを構築。
• 静止画像リクエストに複数のマーカー、パス、GeoJSONオーバーレイを追加します。
• オーバーレイ・データを使用した場合の "オート "ポジショニングの結果をご覧ください。
• 中心座標ペアではなく、バウンディングボックスに基づいて地図画像を生成する。
• マップ画像の全部または一部の辺の視覚的なパディングを調整します。

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

Static Image Playgroundは、Static Images APIリクエストのプロトタイプ作成に最適なツールです。このツールを使って、Static Images API でできることの全容や、各機能の動作を学ぶことができます。API の機能について詳しく学ぼうとする初心者にも、リクエストを視覚的にデバッグする必要がある経験豊富な開発者にも最適です。

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

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

Static Image Playgroundは、現時点では、プログラムによるインターフェースへのアクセスや、プログラムによるStatic Images APIリクエストの生成を許可していません。アプリケーションに直接組み込めるツールをお探しの場合は、mapbox-sdk.jsまたは同等のツールを強くお勧めします。