Mapbox Streets v8
このタイルセットのリファレンスドキュメントには、Mapbox Streets v8 Tilesetのデータを使用する際の情報が含まれています。
概要
Mapbox Streets v8 は、道路、地形、行政境界、建物のフットプリント、土地利用分類、鉄道駅、ポイントオブインタレストなどの幾何学とメタデータを含む、Mapbox 提供のベクタータイルセットです。
Mapbox Streets ベクタータイルを使用して地図スタイルを作成する完全な例については、Mapbox Studio のデフォルトスタイルを参照してください。
データソースと更新
Mapbox Streets v8 ベクタータイルは、Mapbox の独自データ、OpenStreetMap、Microsoft Open Maps、Wikidata などのオープンデータプロジェクト、および日本の Zenrin などのデータベンダーの組み合わせに基づいています。
レイヤー | データソース |
---|---|
admin | グローバル: Mapbox 独自データ |
aeroway | グローバル: OpenStreetMap レプリケーションフィード 日本: OpenStreetMap レプリケーションフィード、Zenrin |
airport_label | グローバル: OpenStreetMap レプリケーションフィード 日本: OpenStreetMap レプリケーションフィード、Zenrin |
building | グローバル: Mapbox 独自データ、OpenStreetMap、Microsoft 日本: Zenrin |
housenum_label | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
landuse_overlay | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
landuse | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
motorway_junction | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
natural_label , types ocean and sea | グローバル: Mapbox 独自データ |
natural_label , all other types | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
place_label , types country and state | グローバル: Mapbox 独自データ |
poi_label | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
road | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
structure | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
transit_stop_label | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
water (海洋部分) | グローバル: OpenStreetMap 日本: Zenrin |
waterway | グローバル: OpenStreetMap レプリケーションフィード 日本: Zenrin |
データ更新
Mapbox Streets ベクタータイルの現在サポートされているバージョンは、新しい情報が利用可能になり、既存の情報が改善されるたびに定期的にデータが更新されます。
データ品質
OpenStreetMap コミュニティーは、世界中の貢献者の日々の努力に加えて、品質保証フィードバックツール や フラグシステム など、データ内のエラーを特定するためのいくつかの方法を使用しています。これにより、ユーザーは可能な誤りや地域の知識を持つ人の注意が必要なエリアを特定できます。
Mapbox には、Mapbox マップの品質を確保し、世界中のフィーチャーを追加および改善することに専念するデータチームもあります。また、マップの偶発的な編集ミスや破壊行為のように見える変更を検出し、データチームが手動でレビューするためにステージングする自動検疫システムを使用しています。
帰属
Mapbox Streets ベクタータイルを使用するスタイルやソフトウェアを公に使用する場合は、適切な帰属を表示 する必要があります。
Mapbox Streets の作成に利用されたソースのリストは Mapbox のウェブサイト で利用可能です。
複数のジオメトリタイプ
Mapbox ベクタータイルは、同じレイヤーに複数のジオメトリタイプをサポートしています。Mapbox Streets v8 はいくつかのレイヤーでこれを利用しています。
ベクタータイル 内のジオメトリは次の3種類のいずれかです:
Mapbox Studio では、各レイヤーのデータ選択タブでジオメトリタイプのトグルを使用して、1つ、2つ、またはすべての3種類を選択できます。
ID
ベクタータイル内の各フィーチ ャーにはオブジェクトIDが含まれています。このIDは Mapbox Studio を通じてスタイリングには使用できませんが、Mapbox GL JS や他のベクタータイルライブラリーを使用してランタイムでフィーチャーと対話するために使用できます。
ID は、関連するデータベンダーまたはオープンデータプロジェクトによって各フィーチャーに割り当てられた一意のIDから派生しています。
しばしば、同じまたは複数の独自ソースからの複数のオブジェクトが、ベクタータイル内で単一のオブジェクトに結合されます。たとえば、水のポリゴンはシームを避けるために結合され、道路の線はスペースを節約するために結合されます。この場合、ID は 0
またはランダムに選ばれた入力IDのいずれかです。
データの安定性
世界の変化を反映するために継続的なデータ更新を行ったり、新しいデータベンダーを統合したりする際、Mapbox Streets v8 Tileに新しいレイヤー、フィールド、値を追加することもあります。私たちの目標は、既存のv8スタイルとの互換性を維持する方法でこれを行うことです。Mapbox Streets v8が将来どのように変化する可能性があるかについて知っておくべきことは次のとおりです:
- レイヤー
- 既存のレイヤーは名前が変更されたり削除されたりしません。
- 新しいレイヤ ーが追加されることがあります。
- フィールド
- 既存のフィールドは名前が変更されたり削除されたりしません。
- 任意のレイヤーに新しいフィールドが追加されることがあります。
- フィールド値
- 既存の値の意味は変更されません。
- 特定のフィーチャーの値は、エラーを修正するためや実世界の変化を反映するために変更されることがあります。
- このドキュメントで特に記載されていない限り、任意のフィールドに新しい値が追加されることがあります。
- Null 値を含む可能性のあるフィールドはこのドキュメントで記載されており、既に持っていないレイヤーにNull値は導入されません。
新しいフィールド値の可能性を考慮してスタイルを設計する必要があります。可能な限りフィルターで明示的にし、式を使用する場合は適切なデフォルトスタイルを含めるようにしてください。
共通フィールド
いくつかのフィールドは、いくつかのレイヤーにわたって使用されます。これらのフィールドは、レイヤー参照 セクションの各関連レイヤーのために重複するのではなく、以下に詳細が記載されています。
name
text および name_<lang-code>
text
ラベル名は多くの言語で利用可能です。特定のフィーチャーに翻訳データがない場合、name_*
の値は null
です。ラベルレイヤーをスタイル設定する際には、適切なフォールバックアプローチを決定する責任があります。
特定のフィーチャーに対して name
フィールドが null の場合、その言語固有の name_*
フィールドもすべて null です。これは、ラベル言語セットに含めたい場合、name
が常に最終的なフォールバック値であるべきことを意味します。
複数の行にレンダリングされるテキストが含まれている場合(水平または垂直)、テキストはゼロ幅スペース文字で区切られます。
フィールド | 説明 |
---|---|
name | その場所で地元で使用されている名前(または名前) |
name_ar | アラビア語 |
name_en | 英語 |
name_es | スペイン語 |
name_fr | フランス語 |
name_de | ドイツ語 |
name_it | イタリア語 |
name_pt | ポルトガル語 |
name_ru | ロシア語 |
name_zh-Hans | 簡体字中国語 |
name_zh-Hant | 繁体字中国語(利用可能な場合がありますが、いくつかの簡体字中国語を含む可能性があります) |
name_ja | 日本語 |
name_ko | 韓国語 |
name_vi | ベトナム語 |
地域のバリエーションがある可能性のある言語の場合、タイルセットは地名の綴りが異なる場合、特定の優先順位を示しません。
name_es
、name_fr
、name_de
のラベルについては、追加のフォールバック条件があります。地元の名前が非ラテン文字体系で書かれており、スペイン語、フランス語、ドイツ語の翻訳がない場合、可能であればこれらのフィールドには英語または国際的なバージョンの名前が表示されます。それ以外の場合は、地元の名前が表示されます。中国語: name_zh-Hant
フィールドには、カスタムラベルレ イヤー #place_label
と #natural_label
の簡体字中国語を使用した標準中国語が含まれています。他のすべてのラベルレイヤーは OpenStreetMap から供給されており、name_zh-Hant
フィールドには、いくつかの方言のうちの1つと簡体字または繁体字のいずれかの中国語文字が含まれている場合があります。name_zh-Hans
フィールドはこれに似ていますが、簡体字に変換された繁体字中国語が自動的に含まれています。name_script
text
name
フィールドがある場合は常に、そのテキストで使用されている主要なスクリプトを説明する name_script
フィールドもあります。これは、フォントや言語のフォールバック条件をカスタマイズするのに役立ちます。値には以下が含まれます:
Arabic
Armenian
Bengali
Bopomofo
Canadian_Aboriginal
Common
Cyrillic
Devanagari
Ethiopic
Georgian
Glagolitic
Greek
Gujarati
Gurmukhi
Han
Hangul
Hebrew
Hiragana
Kannada
Katakana
Khmer
Lao
Latin
Malayalam
Mongolian
Myanmar
Nko
Sinhala
Syriac
Tamil
Telugu
Thaana
Thai
Tibetan
Tifinagh
Unknown
name
が null の場合、値も null です。
sizerank
number
sizerank
フィールドは、poi_label
、natural_label
、airport_label
のようにポリゴンから派生した点や線が含まれているラベルレイヤーに含まれる0から16の値です。これは、現在のズームレベルに対してフィーチャのサイズに基づいてスタイルやフィルタを設定するのに役立ちます。タイルセットは、最大のオブジェクトに sizerank=0
を割り当て、点に sizerank=16
を割り当てます。
単一のフィーチャは、ズームインするにつれて sizerank
が変化し、フィーチャの相対サイズが増加します。例えば、公園はz11でsizerank
が9、z12で6、z13で2になることがあります。
この値が null になることはなく、常に0から16の範囲内にあります。
filterrank
number
filterrank
フィールドは、ラベル密度をカスタマイズするために使用される0から5の値です。これは、スタイルレイヤーフィルタで使用されることを意図しています('Mapbox Studio のデータを選択' タブ)。値は現在のズームレベルに対して相対的です。例えば、同じPOIがz10でfilterrank=5
を持ち、z14でfilterrank=1
を持つことがあります。これはズームインによってPOIの相対的な重要性が変化したためです。
filterrank<=1
を設定して最も目立つラベルのみを表示したり、filterrank<=3
を設定して適度な密度を生成したり、filterrank<=5
を設定して可能な限り多くのラベルを表示することができます。
この値が null になることはなく、常に0から5の範囲内にあります。
maki
テキスト
一部のレイヤーには、Makiアイコンプロジェクトや同様の命名スキームに従う他のアイコンを使用してアイコンを割り当てるのを容易にする maki
フィールドがあります。それぞれのレイヤーは異なる名前のサブセットを使用しますが、Mapbox Streetsで使用されている値の完全なリストがここにまとめられており、異なるレイヤーで必要なすべてのアイコンがスタイルに含まれていることを確認できます。
MakiプロジェクトのすべてのアイコンがMapbox Streetsで使用されているわけではなく、関連するフィーチャの異なるタイプが同じ maki
値を持つこともあります(例えば、大学と短期大学、またはアートショップと美術館など)。名前のないPOIは常に marker
というMaki値を持ち、これは一般的なデフォルトです。
すべてのレイヤーの maki
フィールドの可能な値は以下にリストされています。v7のどのレイヤーにも属していなかったアイコン名は 🆕 でマークされていま す。Mapbox Streets v8ではこれ以上の値が追加されることはありません。
airport_label
:
airport
airfield
heliport
rocket
natural_label
:
marker
mountain
volcano
waterfall 🆕
poi_label
:
alcohol-shop
american-football 🆕
amusement-park
aquarium
art-gallery
attraction
bakery
bank
bar
basketball 🆕
beach 🆕
beer
bicycle
bowling-alley 🆕
bridge 🆕
cafe
campsite
car
car-rental 🆕
car-repair 🆕
casino 🆕
castle
cemetery
charging-station 🆕
cinema
clothing-store
college
communications-tower 🆕
confectionery 🆕
convenience 🆕
dentist
doctor
dog-park
drinking-water
embassy
farm 🆕
fast-food
fire-station
fitness-centre 🆕
fuel
furniture 🆕
garden
globe 🆕
golf
grocery
harbor
hardware 🆕
horse-riding 🆕
hospital
ice-cream
information
jewelry-store 🆕
laundry
library
lodging
marker
mobile-phone 🆕
monument
museum
music
optician 🆕
park
parking 🆕
parking-garage 🆕
pharmacy
picnic-site
pitch 🆕
place-of-worship
playground
police
post
prison
ranger-station 🆕
religious-buddhist 🆕
religious-christian
religious-jewish
religious-muslim
restaurant
restaurant-noodle 🆕
restaurant-pizza 🆕
restaurant-seafood 🆕
school
shoe 🆕
shop
skateboard 🆕
slipway 🆕
stadium
suitcase 🆕
swimming
table-tennis 🆕
tennis 🆕
theatre
toilet
town-hall
veterinary
viewpoint 🆕
volleyball 🆕
watch 🆕
watermill 🆕
windmill 🆕
zoo
transit_stop_label
:
bicycle-share
bus
ferry
rail
rail-metro
rail-light
entrance
maki_beta
text
将来のMapbox Streetsのバージョンでサポートされる可能性のあるMakiアイコンは maki_beta
フィールドにあります。可能な値には以下が含まれますが、これに限定されません:
poi_label
:
baseball
lighthouse
landmark
industry
highway-services
highway-rest-area
racetrack-cycling
racetrack-horse
racetrack-boat
racetrack
religious-shinto
observation-tower
restaurant-bbq
tunnel
natural_label
:
hot-spring
motorway_junction
:
interchange
junction
worldview
テキスト
Mapbox Streets v8は、admin
、airport_label
、natural_label
、place_label
データレイヤーに対して worldview
の概念を導入します。ベクタータイルには、一部のフィーチャの複数のバージョンが含 まれており、それぞれが worldview
値を持ち、対象とする視聴者を示しています。ワールドビューフィルタを適用する場合、all
と地域固有の値のいずれかの両方を含める必要があります。さらに、米国のワールドビュー以外のすべてのワールドビューに対して、対応するレイヤーに disputed_
で始まるクラスがあり、ユーザーはワールドビューフィルタと併せて選択する必要があります。米国ワールドビューの対応するレイヤーのクラスには disputed_
プレフィックスがありません。
admin
データレイヤーを使用するスタイルレイヤーにはワールドビューフィルタを 必ず 適用する必要があります。意図を伝えるために airport_label
、natural_label
、place_label
データレイヤーにもワールドビューフィルタを使用することを強くお勧めしますが、これらのレイヤーにワールドビューを適用しない場合、マップ上に表示されるラベルは米国のワールドビューを反映します。
worldview
フィールドの使用が拡大される場合があります。変更には次のものが含まれる場合があります: - 新しいまたは既存のレイヤーに worldview
の現在の概念を導入すること。 - 他のワールドビューを表すための可能な worldview
値のリストに新しい値を追加すること(データの安定性を参照)。worldview
値によって生成さ れたマップ表示が、必ずしも政府の公式方針を反映するものではなく、政府によって承認されているわけではありません。値 | 説明 |
---|---|
all | すべてのワールドビューに適したもの(ほとんどのフィーチャ) |
CN | 中国本土の観客/ワールドビューに適したフィーチャですが、中華人民共和国での使用は正式に承認されていません。 |
IN | インドでの地図作成要件に適合するフィーチャ。 |
JP | 日本の観客向けのフィーチャですが、必ずしも日本の公式方針を反映しているわけではありません。 |
US | 米国の観客向けのフィーチャですが、必ずしも米国の公式外交政策を反映しているわけではありません。 |
disputed_
クラス テキスト {#disputed_-class-text}
多くのレイヤーには class
フィールドがあります。これらのクラスは、フィーチャの目的や特性に基づいてフィルタリングやスタイリングに使用されることがよくあります。class
フィールドの利用可能な値はレイヤーによって異なり、以下の Layer Reference に詳述されています。
class
フィールドと worldview
フィールドの両方を持つレイヤーでは、class
フィールドの値はそのレイヤーの Layer Reference にリストされている任意の値 または それらの値に disputed_
がプレフィックスとして付けられた値のいずれかです。フィーチャが紛争中とマークされると、disputed_{class}
クラスに分類されます。例えば、紛争中の湾のフィーチャは、bay
クラスではなく disputed_bay
クラスに属します。
disputed
テキスト {#disputed-text}
単一の地図がすべての世界の視点を反映することはありませんが、紛争が存在する場所を認識することは、地図作成の重要な側面であり、より普遍的に使用可能な地図を作成することにつながります。dispute
の値は常に true
か false
のいずれかであり(null になることはありません)、disputed_{class}
クラスを持つフィーチャには disputed
が true
に設定されます。
レイヤーリファレンス
Mapbox Streets v8 Tilesetには以下のレイヤーが含まれています。参照用に、各レイヤーの現在の最小利用可能ズームレベルが記載されていますが、これは更新や改善が進む中で変更される可能性があることに注意してください。また、レイヤー内のすべてのフィーチャに適用されるわけではありません。低番号のズームレベルでは最も目立つ フィーチャのみが利用可能であり、ズームインするにつれてより多くのフィーチャが利用可能になります。物理的に大きなフィーチャのラベルには、サイズに基づいた最大ズームレベルもあります。
レイヤー | 最小ズームレベル |
---|---|
admin | 0 |
aeroway | 9 |
airport_label | 8 |
building | 13 |
housenum_label | 16 |
landuse_overlay | 5 |
landuse | 5 |
motorway_junction | 11 |
natural_label | 0 |
place_label | 0 |
poi_label | 5 |
road | 3 |
structure | 13 |
transit_stop_label | 11 |
water | 0 |
waterway | 7 |