競合他社のアプリで見かけるすべてのマップは、同じデフォルトスタイルを使用しています。ベージュ色の一般的な道路、中間色のティール水、UI要素と競合するごちゃごちゃしたPOIアイコン、これらは誰も怒らず、誰も喜ばないように設計された普遍的なデフォルトです。これは1つのことを明確に伝えています。このプロダクトはマップライブラリを使用しており、マップ体験を所有していないということです。
カスタムマップスタイリングはそれを変えます。ロジスティクスダッシュボード上のダークモードマップ、不動産アプリ上のブランド色の道路ネットワーク、帰属表示の透かしがあった場所にあなたのロゴが配置されたクリーンなミニマルスタイル。これらの詳細がツールをプロダクトに格上げします。
このチュートリアルではMapAtlasで実装されたMapboxスタイル仕様を、スタイルJSONの構造からReactの完全なライト/ダークトグルまで説明します。GIS経験は必要ありません。JSONとJavaScriptに慣れていることが必要です。
まだ基本的なマップをセットアップしていない場合は、まずウェブサイトにインタラクティブマップを追加する方法から始めて、その後ここに戻ってスタイリングについて学んでください。
デフォルトマップスタイルが汎用的に見える理由
タイルプロバイダーのデフォルトスタイルは、最も広い視聴者に対して最も広い文脈で普遍的に読みやすくなるように設計されています。情報密度を美的意見よりも優先します。道路は見えている必要があります。ラベルはコントラストが必要です。POIアイコンは認識可能である必要があります。
これらの目標はあなたのプロダクトの目標と一致しません。あなたのアプリはおそらくマップに表示されているもののごく一部、配達ルート、物件の位置、医療施設に関心があり、他のすべては視覚的ノイズです。
カスタムスタイリングを使用すると、不要なものを抑制し、必要なものを強調し、マップがサードパーティのウィジェットではなくあなたのプロダクトの一部として読まれるようにすることができます。
スタイル仕様を理解する
MapAtlasのスタイルは、5つの主要セクションで構成されるJSONドキュメントです。
{
"version": 8,
"name": "My Brand Style",
"sources": { ... },
"glyphs": "https://cdn.mapmetrics-atlas.net/basemaps-assets/fonts/{fontstack}/{range}.pbf",
"sprite": "https://cdn.mapmetrics-atlas.net/basemaps-assets/sprites/v4/light",
"layers": [ ... ]
}
sources:マップデータの取得元(MapAtlasのベクトルタイルエンドポイント)glyphs:ラベル描画用のフォントファイルの読み込み先sprite:POIマーカー用アイコン画像の読み込み先layers:描画順に並んだビジュアルレイヤーのリスト。各レイヤーがpaintプロパティとlayoutプロパティを持ちます
作業時間の大半はlayers配列に費やします。各レイヤーでは、データタイプ(fill、line、symbol、circle、fill-extrusion)、描画するソースのフィーチャー、そしてその描画方法を指定します。
ベクトルタイルのベースを描画する、最小限ながら完全なスタイルは次のとおりです。
{
"version": 8,
"name": "Brand Base",
"sources": {
"mapatlas": {
"type": "vector",
"tiles": ["https://gateway.mapmetrics-atlas.net/planet20251013/{z}/{x}/{y}.mvt?token=YOUR_API_KEY"],
"minzoom": 0,
"maxzoom": 14
}
},
"glyphs": "https://cdn.mapmetrics-atlas.net/basemaps-assets/fonts/{fontstack}/{range}.pbf",
"sprite": "https://cdn.mapmetrics-atlas.net/basemaps-assets/sprites/v4/light",
"layers": [
{
"id": "background",
"type": "background",
"paint": { "background-color": "#f5f0eb" }
}
]
}
これで、選んだ背景色の空白のキャンバスが描画されます。ここから水域、土地利用、道路、建物、ラベルのレイヤーを追加していきます。
ダークモード:コアカラーの変更
ダークモードマップは単に反転ラスタ画像ではありません。同じベクタージオメトリに適用される、まったく異なるペイントプロパティのセットです。これはベクトルタイルが存在する主な理由の1つです。1つのタイル、無限の視覚的解釈。
ダークテーマで更新すべき主要な色は次のとおりです。
| レイヤー | ライトモード | ダークモード |
|---|---|---|
| 背景(陸地) | #f5f0eb | #1a1a2e |
| 水域 | #a8d5e5 | #0d3b66 |
| 市街地の土地利用 | #e8e0d5 | #16213e |
| 公園・緑地 | #c8e6c9 | #1b4332 |
| 道路(主要) | #ffffff | #3a3a5c |
| 道路(一般) | #efefef | #2d2d4a |
| 道路ラベル | #333333 | #cccccc |
スタイルレイヤーでは次のように適用します。
{
"id": "water",
"type": "fill",
"source": "mapatlas",
"source-layer": "water",
"paint": {
"fill-color": "#0d3b66",
"fill-opacity": 1
}
}
{
"id": "road-major",
"type": "line",
"source": "mapatlas",
"source-layer": "transportation",
"filter": ["==", "class", "primary"],
"layout": {
"line-join": "round",
"line-cap": "round"
},
"paint": {
"line-color": "#3a3a5c",
"line-width": ["interpolate", ["linear"], ["zoom"], 10, 1, 16, 4]
}
}
line-widthのinterpolate式は、ズームレベルに基づいて道路幅をスケーリングします。低ズームで狭く、ズームインすると広くなります。これは追加のネットワークリクエストなしのデータドリブンスタイリングです。
ブランドカラーの適用
ほとんどのデザインシステムは、プライマリカラー(例:#97C70A)、セカンダリカラー、ニュートラルパレットを定義しています。マップはこれらの同じ値を使用する必要があり、近似値ではありません。
ブランドカラー適用の対象となるレイヤーは次のとおりです。
ブランド要素としての道路。 ブランドカラーが十分に活気のある場合は、主要な道路またはハイライトされたルートに使用します。
{
"id": "road-highlighted",
"type": "line",
"source": "mapatlas",
"source-layer": "transportation",
"filter": ["==", "class", "primary"],
"paint": {
"line-color": "#97C70A",
"line-width": 3,
"line-opacity": 0.8
}
}
カスタムPOIマーカー。 カスタムスプライトシートをホストしてsprite URLを更新することにより、デフォルトのスプライトアイコンを自分のものに置き換えます。次に、シンボルレイヤーであなたのアイコンを参照します。
{
"id": "brand-poi",
"type": "symbol",
"source": "mapatlas",
"source-layer": "poi",
"layout": {
"icon-image": "brand-pin",
"icon-size": 1.2,
"text-field": ["get", "name"],
"text-font": ["Inter Bold", "Noto Sans Regular"],
"text-size": 12,
"text-offset": [0, 1.5],
"text-anchor": "top"
},
"paint": {
"text-color": "#97C70A",
"text-halo-color": "#1a1a2e",
"text-halo-width": 1
}
}
マップラベル用のカスタムフォント
デフォルトのマップラベルフォントは汎用的です。ブランドがInter、Roboto、またはカスタムタイプフェイスを使用している場合は、マップラベルにも使用できます。
MapAtlasは独自のグリフエンドポイントからグリフを提供し、標準的なMapboxグリフ形式をサポートしています。カスタムフォントを使用するには:
fontnikなどのツールを使用して、タイプフェイスから.pbfグリフファイルを生成します。- グリフファイルをCDNまたは独自のサーバーでホストします。
- スタイルJSONの
glyphsフィールドを更新します:
{
"glyphs": "https://your-cdn.com/fonts/{fontstack}/{range}.pbf"
}
- シンボルレイヤーの
text-fontプロパティでフォントを参照します:
"text-font": ["Inter Bold", "Noto Sans Regular"]
常にフォールバックフォントを提供します(Noto Sansはプライマリフォントに含まれないUnicode文字をカバーします)。レンダラーは、配列内の各文字のグリフを含む最初のフォントを使用します。
透かしと帰属表示の削除
MapAtlasは完全なホワイトラベルデプロイメントを許可します。マップからMapAtlasロゴを完全に削除できます。ただし、データライセンスが求めるOpenStreetMapのクレジットは残します。
SDKでは、帰属表示は無効にできるコントロールで処理されます:
const map = new mapmetricsgl.Map({
container: 'map',
style: 'https://gateway.mapmetrics-atlas.net/styles/?fileName=YOUR_STYLE_ID/style.json&token=YOUR_API_KEY',
center: [4.9041, 52.3676],
zoom: 12,
attributionControl: false, // デフォルトの帰属表示コントロールを削除します
});
帰属表示を保持したいが、UIに合わせてスタイリングする場合は、デフォルトコントロールを非表示にして、独自のものを追加します:
map.addControl(
new mapmetricsgl.AttributionControl({
customAttribution: 'Map data © OpenStreetMap contributors',
compact: true,
}),
'bottom-left'
);
これにより、ブランディングを、UIに合わせながらOpenStreetMapのライセンスを尊重する最小限の法的準拠の帰属表示に置き換えます。そのため、マップをどうブランディングするかは完全に自分でコントロールできます。
Reactでのライト/ダークテーマトグル
CSS カスタムプロパティを使用してテーマをUIの残りの部分と同期させ、ライト/ダークトグルでマップを管理する完全なReactコンポーネントは次のとおりです:
import { useEffect, useRef, useState } from 'react';
import mapmetricsgl from '@mapmetrics/mapmetrics-gl';
import '@mapmetrics/mapmetrics-gl/dist/mapmetrics-gl.css';
const STYLES = {
light: 'https://gateway.mapmetrics-atlas.net/styles/?fileName=YOUR_STYLE_ID/style.json&token=YOUR_API_KEY',
dark: 'https://gateway.mapmetrics-atlas.net/styles/?fileName=YOUR_DARK_STYLE_ID/style.json&token=YOUR_API_KEY',
};
export function BrandedMap({ center = [4.9041, 52.3676], zoom = 12 }) {
const containerRef = useRef(null);
const mapRef = useRef(null);
const [theme, setTheme] = useState('light');
useEffect(() => {
const map = new mapmetricsgl.Map({
container: containerRef.current,
style: STYLES.light,
center,
zoom,
attributionControl: false,
});
map.addControl(
new mapmetricsgl.AttributionControl({ compact: true }),
'bottom-left'
);
mapRef.current = map;
return () => map.remove();
}, []);
useEffect(() => {
if (mapRef.current) {
mapRef.current.setStyle(STYLES[theme]);
}
}, [theme]);
return (
<div style={{ position: 'relative' }}>
<div ref={containerRef} style={{ width: '100%', height: '500px' }} />
<button
onClick={() => setTheme(t => t === 'light' ? 'dark' : 'light')}
style={{
position: 'absolute',
top: 12,
right: 12,
padding: '8px 16px',
background: theme === 'dark' ? '#ffffff' : '#1a1a2e',
color: theme === 'dark' ? '#1a1a2e' : '#ffffff',
border: 'none',
borderRadius: 6,
cursor: 'pointer',
zIndex: 1,
}}
>
{theme === 'light' ? 'Dark mode' : 'Light mode'}
</button>
</div>
);
}
setStyle呼び出しはマップを新しいカラースキームで再レンダリングします。キャッシュに既にあるタイルデータは再取得されず、視覚的な解釈のみが変わります。
カスタムスタイルJSONのホスティング
完全なコントロールのために、CDNまたはS3バケットに静的ファイルとしてスタイルJSONをホストします。これにより、以下が可能になります:
- アプリケーションコードと一緒にスタイルをバージョンコントロールします。
- アプリケーションを再デプロイせずに視覚的なデザインを更新します(ホストされたJSONを更新するだけです)。
- 異なる環境に異なるスタイルを使用します(プレビューと本番環境など)。
ランタイムでホストされたスタイルを読み込みます:
const map = new mapmetricsgl.Map({
container: 'map',
style: 'https://your-cdn.com/styles/brand-dark.json',
center: [4.9041, 52.3676],
zoom: 12,
});
唯一の制約はCORSです。スタイルJSONはAccess-Control-Allow-Origin: *(またはあなたの特定のドメイン)で提供される必要があります。ブラウザがクロスオリジンで取得できるようにするためです。
スタイル開発ワークフロー
カスタムスタイルを構築する最速の方法は、反復的であり、コードを書き直すことなくリアルタイムで変更を確認することです。
- MapAtlasベーススタイルJSONを基盤として始めます。MapMetricsポータルの Styles でスタイルを作成し、そのStyle URLをコピーしたうえで、そのURLを取得してJSONをダウンロードします。
- エディタでJSONを編集し、どのレイヤーがどの視覚要素に影響するかを監視します。
- 修正されたスタイルJSONでマップを再度読み込んで、結果を確認します。
- 安定したら、リポジトリにスタイルJSONをコミットして、CDNでホストします。
さらに詳細なカスタマイズについては、マップ可視化とスタイリングドキュメントを確認して、完全なレイヤーリファレンス、ペイントプロパティタイプ、および式の構文を確認してください。
Mapboxから来たのであれば、何が変わったのかを知りたい場合は、Mapbox vs. MapAtlas:EU プロジェクトに適したマップAPIはどちらですか?を参照して、機能と価格の並列比較を確認してください。
ベクトルタイルがすべてを可能にする建築的な基礎については、ベクトルタイル対ラスタータイルがレンダリングパイプラインを詳しく説明しています。
まとめ
カスタムマップスタイリングは贅沢ではなく、サードパーティのウィジェットのように感じるマップと、あなたのプロダクト用に構築されたように感じるマップの違いです。MapAtlasを使用すると:
- スタイル仕様はMapbox GL JSツーリングと互換性のある標準JSONです。
- ダークモードはスタイルJSONスワップであり、新しいタイルセットまたはサーバー設定ではありません。
- ブランドカラーは、ペイントプロパティを通じて道路、ラベル、POIアイコンに適用されます。
- カスタムフォントは、制御するグリフエンドポイントから読み込まれます。
- 透かしと帰属表示は完全に設定可能であり、ホワイトラベルはすべての有料プランでサポートされています。
- スタイル全体は、ページを再度読み込むことなくランタイムで切り替えることができます。
今日、ブランド化されたマップを構築し始めてください。無料のMapAtlas APIキーにサインアップして、ベーススタイルJSONを出発点として読み込みます。最初のカスタムスタイルは約30分で完成し、その後の反復は数分で完成します。
よくある質問
マップから MapAtlas の透かしを削除できますか?
はい。MapAtlas は完全なホワイトラベルマップを許可しています。MapAtlas のロゴを完全に削除して独自のブランディングに置き換えることができ、残す必要があるのはオープンライセンスが求める小さな OpenStreetMap のデータクレジットだけです。
MapAtlas のスタイル形式は Mapbox GL JS のスタイルと互換性がありますか?
はい。MapAtlas は Mapbox Style Specification を使用しており、Mapbox GL JS および MapLibre GL と同じ JSON 形式です。既存の Mapbox スタイル JSON は、ソース URL を更新するだけで MapAtlas でそのまま動作します。
ページをリロードせずにライトとダークのマップスタイルを切り替えられますか?
はい。新しいスタイル URL またはオブジェクトで map.setStyle() を呼び出します。マップは新しいビジュアル設定で再レンダリングされ、すでにキャッシュされたタイルデータは再取得されません。CSS カスタムプロパティと組み合わせることで、テーマに対応したシームレスなマップコンポーネントを実現できます。

