道路レイヤー (交通機関)

roadsレイヤーには、高速道路、主要道路、生活道路、小道、鉄道、フェリーなど、さまざまなタイプを網羅した包括的な交通機関データが含まれています。たとえば、このデータセットはフリートマネジメント アプリケーションで重要となり、承認されたルートや制限に従うことで車両が確実に規制を順守するようにします。

次の図は、ベクター データからレンダリングされた道路の例です。

レイヤーのコンテンツの定義は次のとおりです。

• レイヤー名：roads
• ジオメトリータイプ：line、point

以下のセクションでは、HERE Vector Tile APIのroadsレイヤーの概要を説明します。

📘

注

roads レイヤーを使用するときには、次の設計上の特性や制約を考慮してください。

• レイヤーを重ねて陸橋、橋、トンネルを正確に表現するには、sort_rank を適用して適切なレイヤー構造にします。
• パフォーマンスを向上させるため、低いズーム値および中程度のズーム値では一部の道路区間が結合されます。つまり、これらのズーム レベルでは、is_bridge、is_tunnel、name、network、oneway、ref などの特定のプロパティが削除されます。どのズーム レベルからプロパティが適用されなくなるかは、フィーチャーのクラスによって異なります。
• 高度な道路レイヤーではroadsレイヤーが拡張され、重量物運搬車 (HGV) の要件を満たすように特別に設計された専門的な情報を表示します。詳細については、「高度な道路レイヤー」を参照してください。

共有プロパティ

roadsレイヤーのすべてのフィーチャーには、そのフィーチャーが表す特定のタイプの道路にかかわらず、そのフィーチャーを定義する一連のプロパティが含まれています。

📘

注

これらのプロパティは、Tilezen スキーマでは common プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

• name - 現地言語での道路の名前。使用可能なデータによっては、名前が複数の言語で提供される場合もあります。
• kind - 道路の一般的なタイプ。詳細については、「roads レイヤーの kind 値」を参照してください。
• kind_detail - 道路の kind の追加情報。たとえば、minor_road kind は、residential、service、または unclassified を kind_detail 値として指定できます。詳細については、「roads レイヤーの kind_detail 値 」を参照してください。
• landuse_kind - roads に landuse レイヤーを挿入することによって計算されるプロパティ。道路区間が公園、病院、大学などの landuse フィーチャーの上にあるかどうかを判断します。このプロパティを使用して、これらのフィーチャーと重なる道路の外観を変更します。たとえば、landuse の色の上にライト グレーの生活道路を重ねると、ほとんどの場合、色を濃くしなければ識別できない可能性があります。
• sort_rank - 地図上のさまざまなタイプのフィーチャーの表示順序を優先させるために使用される値。sort_rank 値が大きいフィーチャーが、sort_rank 値が小さいフィーチャーの上に表示されます。ズーム レベル 14 以上で sort_rank が調整され、橋やトンネルが写実的に表現されます。たとえば、is_bridge=true フィーチャーの場合、ズーム レベル 13 の sort_rank 値は 337 ですが、ズーム レベル 14 では sort_rank 値が 427 に変更されます。
• min_zoom - roads が表示されるようになる推奨最小ズーム レベルを表します。
• ref - 一般的に使用される roads フィーチャーの参照。たとえば、州間高速道路 90 の場合は "I 90" です。標識で使用するには、network および shield_text プロパティの定義を参照してください。
• network - 標識や道路の選択に便利です。たとえば、米国の州際高速道路ネットワークは US:I です。プロパティには道路ネットワーク タイプのみが含まれています。使用可能な値の完全なリストについては、「道路 network の値」を参照してください。
• shield_text - 道路標識に表示されるテキストを表します。たとえば、I 90 道路は US:I ネットワークに属し、shield_text は 90 です。一方、この ref 値 (I 90) には追加情報が含まれているため、追加の処理を行わずに直接標識に表示するには不向きな場合もあります。道路によっては、このプロパティに数字以外の文字も含まれます。たとえば、英国の M1 モーターウェイの shield_text 値は 1 だけではなく M1 です。
• all_shield_texts - 特定の道路に関連付けられているすべての標識テキストを一覧表示します。テキストはセミコロンで区切られた shield_text 値の集まりとして表されます。詳細については、shield_textプロパティの定義を参照してください。
• all_networks - 特定の道路に関連付けられているすべてのネットワークです。これらのネットワークはセミコロンで区切られた network 値の集まりとして表されます。詳細については、networkプロパティの定義を参照してください。
• all_route_types - 指定された道路を含むさまざまなルート タイプ。これらのタイプはセミコロンで区切られた一連の数値コードとして表されます。これらのコードはその国の仕様に基づいた標識のスタイル設定に使用されます。
• all_refs - この道路に関連付けられているすべての参照を含みます。これらの参照はセミコロンで区切られた一連の ref 値として表されます。詳細については、refプロパティの定義を参照してください。

条件プロパティ

一部のroadsフィーチャーには、特定の道路がトンネルや橋の一部であるかどうかなどの追加情報を提供するプロパティが含まれます。

📘

注

これらのプロパティは、Tilezen スキーマでは common-optional プロパティと呼ばれます。詳細については、「タイルレイヤー」を参照してください。

• is_bridge - 道路が橋の一部である場合にのみtrueに設定して表示します。
• is_link - 道路が高速道路の接続路またはランプの一部である場合にのみ true に設定して表示します。
• is_tunnel - 道路がトンネルの一部である場合にのみ true に設定して表示します。
• is_present_in_landuse - expressway、urban_expressway、national_road、major_road、other_road などのさまざまな土地利用カテゴリー内に、この道路の詳細なポリゴン表現があるかどうかを示します。また、生活道路の特定の土地利用カテゴリーに含まれていない領域として形成される場合もあります。このプロパティは core 地図パラメーター内のみに存在し、日本のカバレージがズーム レベル 14 に制限されています。土地利用データから取得した包括的な道路ジオメトリーを表示しながら、道路中心線のフィルタリングを容易にします。詳細については、「道路ポリゴン」を参照してください。
• is_present_in_city - 鉄道が都市鉄道ネットワークに統合されている場合は true に設定します。このプロパティは core 地図パラメーター内でのみ使用でき、日本に適用可能なカバレージがズーム 14 以上に制限されています。このプロパティを持つ鉄道は、都市鉄道ネットワークから取得したライン ジオメトリーを表示するときのラベル付けの目的にのみ使用されます。このプロパティは rail kind にのみ適用されます。
• pedestrian_zone - 歩行者道路が歩行者ゾーンの一部である場合はtrueに設定します。
• public_access - その要素にアクセスするための公式かつ法的に保護された権利を一般市民が有する場合は true に設定します。
• private - その要素が一般市民に開放されておらず、許可された個人のみにアクセスが許される場合は true に設定します。
• delivery_road - その要素への配達時にのみアクセスが許可される場合は true に設定します。
• through_traffic - 出発地と目的地の両方が現在の道路の外部にある場合にのみ、道路を通過することが許可されている場合はtrueに設定します。
• fclass - このプロパティは、kind_detail:motorwayおよびkind_detail:motorway_linkの道路の機能クラスの数値を示します。詳細については、「fclass 値」を参照してください。
• under_construction - 道路が工事中であり、一部またはすべてのタイプの交通で使用できない可能性があるときに true に設定して表示します。
• surface - 道路が舗装されていない場合にのみ unpaved に設定して表示します。
• oneway - 交通の流れが一方向で、linestring と同じ方向に移動するかどうかを示す任意のプロパティです。このプロパティには yes の値のみを指定できます。
• toll - 一般的な交通手段を使ってこのフィーチャーを使用する場合、料金を支払う必要があるかどうかを示す任意のブール型プロパティです。このプロパティには true の値のみを指定できます。
• z_level - 地図上のフィーチャーの読み込みとレンダリングの順序を管理するための任意のプロパティです。実際に見える上下関係をミラーリングします。プロパティが存在しない場合、デフォルト値は 0 です。z_level の値が大きい道路は、値が小さい道路の後に描画されます。z_level 値の現在の許容範囲は -4 ～ 5 です。

次の図は、さまざまな z_level 値を持つサンプル フィーチャーを示す地図を示しています。この例では、z_level 値が大きいフィーチャーが、z_level 値が小さいフィーチャーの「上」に描画される様子を示しています。

roads レイヤーの kind 値

次のリストは、使用できる roads レイヤー フィーチャー タイプの詳しい説明と、サポートされているジオメトリー タイプをまとめたものです。

roads レイヤーの kind_detail 値

次の表は、道路の種類についての追加情報を提供できる kind_detail 値をまとめたものです。

kind_detail: service の service 値

kind:minor_road および kind_detail:service の道路は、次のプロパティを追加で持つことができます。

• parking_aisle - 一般的に、駐車スペースにアクセスするための走行レーンとして機能する、駐車場または立体駐車場内の指定エリアを指します。

日本固有の kind_detail 値

以下の表は、core マップの日本固有の kind_detail 値です。詳細については、「地図パラメーター」を参照してください。

• light_rail - railkind用
• subway - rail kind 用
• speed_rail - rail kind の高速鉄道用
• private_rail - rail kind の私有鉄道用
• state_rail - rail kind の国有鉄道用
• monorail - rail kind のモノレール用
• roller_coaster - rail kind のジェットコースター用
• cable_car - aerialway kind 用
• gondola - aerialway kind 用

fclass値

HERE Vector Tile APIの道路は従来、いわゆる機能クラスに分類されていますが、これらはTilezenの道路分類と1対1で一致していません。両者の対応付けは次のとおりです。

日本固有のfclass値

以下の表は、core マップの日本固有の fclass 値です。詳細については、「地図パラメーター」を参照してください。

次のステップ

• HERE Vector Tile APIで使用できる他のレイヤーフィーチャータイプの詳細については、「タイルレイヤー」を参照してください。