ガイドAPIリファレンス
ガイド
  1. HERE Map Attributes API V8
  2. 概念

HERE Map Attributes API V8のルート検索ゾーン

サポートされているルート検索ゾーンに対してクエリを行うには、ROUTING_ZONESレイヤーを使用します。レイヤーには、HERE Routing API V8で使用できるゾーンの識別子が含まれています。たとえば、avoid[zoneIdentifiers]パラメーターでは、ルートの計算時に回避するゾーンを指定できます。ROUTING_ZONESレイヤーの属性 (列) は次のとおりです。

属性説明
ZONE_IDゾーンの識別子。
ZONE_TYPEゾーンのタイプ。
ZONE_NAMEゾーンの名前。
ISO_COUNTRY_CODEゾーンが位置する国のISOコード。

ルート検索ゾーンを取得する

ROUTING_ZONESレイヤーからデータを取得するには、/v8/maps/attributesリソースを使用します。必要なパラメーターは、layersとin、およびapiKeyまたはapp_idのいずれか、およびapp_codeです。

サポートされているルート検索ゾーンをすべての地域から取得するには、次のリクエストを送信します。

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ROUTING_ZONES'\
'&in=all'\
'&apiKey={YOUR_API_KEY}'

WEU (西欧)、EEU (東欧)、NA (北米)、APAC (アジア太平洋) などの地域に対応するルート検索ゾーンを取得するには、&mapNameパラメーターを使用します。次のリクエストは、サポートされているルート検索ゾーンを北米地域から取得します。

サンプルリクエスト

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ROUTING_ZONES'\
'&in=all'\
'&mapName=NA'\
'&apiKey={YOUR_API_KEY}'

サンプルレスポンス

Click to view the sample response.
{
  "geometries": [
    {
      "attributes": {
        "ZONE_NAME": "NYC CONGESTION PRICING",
        "ZONE_ID": "here:cm:tollsystem:8131",
        "ISO_COUNTRY_CODE": "USA",
        "ZONE_TYPE": "congestion"
      },
      "layerId": "ROUTING_ZONES"
    },
    {
      "attributes": {
        "ZONE_NAME": "Hidalgo Hoy No Circula",
        "ZONE_ID": "here:cm:envzone:456",
        "ISO_COUNTRY_CODE": "MEX",
        "ZONE_TYPE": "environmental"
      },
      "layerId": "ROUTING_ZONES"
    },
    {
      "attributes": {
        "ZONE_NAME": "Zona Metropolitana Valle de México",
        "ZONE_ID": "here:cm:envzone:79",
        "ISO_COUNTRY_CODE": "MEX",
        "ZONE_TYPE": "environmental"
      },
      "layerId": "ROUTING_ZONES"
    },
    {
      "attributes": {
        "ZONE_NAME": "San Jose Restriccion Vehicular",
        "ZONE_ID": "here:cm:envzone:458",
        "ISO_COUNTRY_CODE": "CRI",
        "ZONE_TYPE": "environmental"
      },
      "layerId": "ROUTING_ZONES"
    }
  ]
}

フィルタリング

&filterパラメーターを使用すると、サポートされているルート検索ゾーンを除外できます。フィルターはROUTING_ZONESレイヤーのすべての属性に適用できます。フィルターはSQL式であり、URLエンコードされている必要があります。

たとえば、以下のリクエストを使用すると、ISO国コードMEXで表されるメキシコでサポートされているルート検索ゾーンを取得できます。

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ROUTING_ZONES'\
'&in=all'\
'&filter=ISO_COUNTRY_CODE%3D%22MEX%22'\
'&apiKey={YOUR_API_KEY}'

このリクエストはすべての地域のenvironmentalゾーンのみを返します。

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ROUTING_ZONES'\
'&in=all'\
'&filter=ZONE_TYPE%3D%22environmental%22'\
'&apiKey={YOUR_API_KEY}'

フィルターはレイヤーの複数の属性に適用できます。これについては、ドイツのすべてのenvironmentalゾーンを取得する、次のサンプルリクエストをご覧ください。

curl -gX GET 'https://smap.hereapi.com/v8/maps/attributes?'\
'layers=ROUTING_ZONES'\
'&in=all'\
'&filter=ISO_COUNTRY_CODE%3D%22DEU%22%20and%20ZONE_TYPE%3D%22environmental%22'\
'&apiKey={YOUR_API_KEY}'

レスポンスの属性はレイヤーに関連付けられます。使用可能なレイヤーとその属性のリストを表示するには、次のURLにアクセスします。

https://smap.hereapi.com/v8/maps/layers/list.html?&apiKey={YOUR_API_KEY}

7 日前の更新