API docs by Redocly

ベクター地図API (v2.0)

Download OpenAPI specification:Download

ベクター地図APIサービスでは、GeoTechnologies製日本地図データのベクタータイルを配信します。
配信されるベクタータイルは MVT(MapBox Vector Tile) 形式にて提供します。

本APIが利用するデータのファイル形式は PMTiles です。
ベクター地図API v1 にて採用している MBTiles と比較し、 配信データの軽量化によるネットワークトラフィックの削減や、ブラウザやクラウド環境での高速なタイル読み込みのための最適化が行われています。
※APIへの大規模なアクセスが見込まれる場合は、v1ではなく本API（v2）をご利用ください。

ベクター地図API

本APIのご利用に際しては、以下をご留意ください。

  • 本API（v2）は、 Mapbox GL JS ではご利用いただけません。
    MapLibre GL JS など、 PMTilesに対応したクライアントライブラリをご利用ください。
    MapLibre GL JSでのご利用にあたっては、 PMTilesライブラリ が必要です。
  • 本APIのPV（ページビュー）は、z/x/yで表される地図タイル領域 15エリア分のアクセスにつき、1カウントされます。
    地図タイルは複数のデータソースで構成されますが、個々のデータソース単位でのアクセスはカウントせず、1つの地図タイル領域につき1アクセスとなります。
    また、style glyph sprite へのアクセスはカウントされません。

スタイルファイル取得

ベクター地図をレンダリングするクライアントライブラリ向けに、スタイルファイル取得の機能を提供します。
スタイルファイルはベクター地図を描画する際に必要となるベクタータイルデータ・リソースの取得先や、地図デザインの設定が含まれます。
スタイルファイルの仕様は Mapbox Style Specification に準拠します。

path Parameters
stylename
required
string

取得したいスタイルの名称を指定します。
指定できる値は下記の通りです。

  • mapfan（MapFan標準デザイン）
  • mapfan_nologo（MapFan標準デザイン・ブランドロゴ非表示）
  • mapfan_light（MapFan淡色デザイン）
  • mapfan_light_nologo（MapFan淡色デザイン・ブランドロゴ非表示）
header Parameters
x-api-key
required
string

APIキーによる認証を行います。弊社より提供されたAPIキーを記述してください。
※APIキーは漏えいさせないように管理をお願いいたします。

Responses

スタイルファイル取得（エディター向け）

ベクター地図スタイルエディター向けに、スタイルファイル取得の機能を提供します。 下記のスタイルエディター環境にて、動作確認しています。

クライアントライブラリ向けには、「スタイルファイル取得」の機能をご利用ください。

path Parameters
stylename
required
string

取得したいスタイルの名称を指定します。
指定できる値は下記の通りです。

  • mapfan（MapFan標準デザイン）
  • mapfan_nologo（MapFan標準デザイン・ブランドロゴ非表示）
  • mapfan_light（MapFan淡色デザイン）
  • mapfan_light_nologo（MapFan淡色デザイン・ブランドロゴ非表示）
query Parameters
api_key
required
string

APIキーによる認証を行います。弊社より提供されたAPIキーを記述してください。
※APIキーは漏えいさせないように管理をお願いいたします。

Responses

変更履歴

日付 内容
2025年4月10日 新規作成