EV充電ポイント

📘
注
EV充電ポイント機能の価格については、「HERE基本プランの価格表」を参照してください。価格についてご質問がある場合は、お問い合わせください。

このセクションでは、クエリパラメーターshow=evまたはshow=eMobilityServiceProvidersが設定されている場合にHERE Geocoding and Searchによって返されるEV充電ポイント属性について説明します。

EV充電ポイント属性は、次のカテゴリーIDの場所の結果に属します。

700-7600-0322 (EV充電スポット (乗用車用))
700-7600-0323 (EV充電スポット (トラック用))
700-7600-0324 (EV充電スポット (二輪車、小型乗用車用))

EV充電ステーションは、同じ充電ポイントオペレーター (CPO) に属し、同じフィーチャーを共有する近くのEV供給装置 (EVSE) のクラスターです。ほとんどの場合、CPO名は場所の結果titleを表すために使用されます。

EVステーションコネクターの情報

HERE Geocoding and SearchでEVステーションコネクターの属性を取得するには、専用のクエリパラメーターshow=evを使用します。

show=evクエリパラメーターの使用を許可されているお客様には、常にCPO名がsupplierNameフィールド値として表示されます。

show=evオプションをサポートするエンドポイントは、/browse、/discover、/lookupエンドポイントです。

例：EVステーションの結果

たとえば、次の/browseエンドポイントは、現在の車両の位置(at= 52.3039368,4.7509823)に最も近い3つのEVステーションを返します。最初のステーションの運営会社は Electrify America、二番目はTeslaというように続きます。

GET https://browse.search.hereapi.com/v1/
    browse
    ?at=52.3039368,4.7509823
    &categories=700-7600-0322
    &limit=3
    &show=ev
-H 'Authorization: Bearer{YOUR_TOKEN}'

{
  "items": [
    {
      "title": "EVBox",
      "extended": {
        "evStation": {
          "connectors": [
            { "supplierName": "EVBox",
      ...
    },
    {
      "title": "TotalEnergies",
      "extended": {
        "evStation": {
          "connectors": [
            { "supplierName": "TotalEnergies",
      ...
    },
    {
      "title": "Maxem Energy",
      "extended": {
        "evStation": {
          "connectors": [
            { "supplierName": "Maxem Energy",
      ...
    }
  ]
}

各EV充電スポットの結果項目には、一連の拡張属性があります。これらは2つの異なる形で見られます。

グループ形式：extended.evStation.connectors配列では、EV充電スポットを、同じタイプと最大電力レベルを特徴とするコネクターのグループとして記述します。
詳細形式：extended.evAvailability.stations配列には、ステーション、EV供給機器 (EVSE)、コネクターのさらなる詳細が含まれています。充電機器の利用状況の詳細はEVSEのレベルで確認できます。

コネクターをグループ化することで、結果のリスト内でのコンパクトで読みやすいレンダリングが促進され、エンドユーザーは自身に関連する検索結果項目をすばやく選択できます。

EV充電スポットの詳細な表現は、EVSE識別子の使用を通じてCPOプラットフォームと対話するアプリケーションの開発を容易にすることを目的としています。

各属性の説明については、APIリファレンスのドキュメントを参照してください。

例：EVステーションの属性

/browseエンドポイントの例では、最初のレスポンス項目がニュージャージー州カーニー(米国)の150 Harrison AvenueにあるEV充電スポットです。次の詳細な表現があります。

4つのEVSE：このステーションでは4台の電気自動車を同時に充電できます。
1つ目のEVSEは、タイプID33の1つのコネクター (IEC 62196-3タイプ1コンボ、別名「CCS」) に350 kWを供給するか、タイプID29の1つのコネクター (JEVS G 105、別名「CHAdeMO」) に50 kWを供給します。
2つ目と3つ目のEVSEは、タイプID 33の1つのコネクターにそれぞれ350 kWを供給します。
4つ目のEVSEは、タイプ30 (IEC 62196-2タイプ1、別名「レベル2」) の1つのコネクターに7.2 kWを供給します。

上記の5つのコネクターに関する情報は、ソケットの3つのグループに集約されます。

最初のグループ：タイプ ID 29 の 1 つのコネクターに最大 50 kW が供給されます
2 番目のグループ：タイプID 33 の3つのコネクターは最大350 kWで給電されます
3 番目のグループ：タイプ ID 30 の 1 つのコネクターに最大 7.2 kW が供給されます

2023年9月28日11:47 UTCの属性は次のとおりです。

{
  "title":"Electrify America",
  "id": "here:pds:place:evcp0-MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAz",
  "resultType": "place",
  "address": {
    "label":"Electrify America, 150 Harrison Ave, Kearny, NJ 07032-5950, United States",
    ...
  },
  "position": { "lat":40.74863, "lng": -74.13629 },
  "categories": [{ "id":"700-7600-0322", "name":"EV Charging Station", "primary": true }],
  ...
  "extended": {
    "evStation": {
      "connectors": [
        {
          "supplierName":"Electrify America",
          "connectorType": { "name":"IEC 62196-3 type 1 combo (SAE J1772)", "id":"33" },
          "fixedCable": true,
          "maxPowerLevel":350,
          "chargingPoint": {
            "numberOfConnectors":3,
            "voltsRange":"1000-1000V DC",
            "ampsRange":"350A",
            "numberOfAvailable":1,
            "numberOfInUse":2,
            "lastUpdateTimestamp":"2024-08-26T14:57:43.000Z"
          }
        },
        {
          "supplierName":"Electrify America",
          "connectorType": { "name":"IEC 62196-2 type 1 (SAE J1772)", "id":"30" },
          "fixedCable": true,
          "maxPowerLevel":7.2,
          "chargingPoint": {
            "numberOfConnectors":1,
            "voltsRange":"240-240V AC",
            "phases":1,
            "ampsRange":"30A",
            "numberOfAvailable":1,
            "lastUpdateTimestamp":"2024-08-25T23:08:53.000Z"
          }
        }
      ],
      "totalNumberOfConnectors":4,
      "access": "public"
    },
    "evAvailability": {
      "stations": [
        {
          "id":"MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAz",
          "cpoId":"200104",
          "evses": [
            {
              "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMw",
              "cpoId":"200104-03",
              "cpoEvseEMI3Id":"200104-03",
              "state":"OCCUPIED",
              "last_updated":"2024-08-26T14:36:54.000Z",
              "connectors": [
                {
                  "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMzox",
                  "cpoId":"1",
                  "typeId":"33",
                  "maxPowerLevel":350
                }
              ]
            },
            {
              "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMQ",
              "cpoId":"200104-01",
              "cpoEvseEMI3Id":"200104-01",
              "state":"OCCUPIED",
              "last_updated":"2024-08-26T14:57:16.000Z",
              "connectors": [
                {
                  "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMTox",
                  "cpoId":"1",
                  "typeId":"33",
                  "maxPowerLevel":350
                }
              ]
            },
            {
              "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMg",
              "cpoId":"200104-02",
              "cpoEvseEMI3Id":"200104-02",
              "state":"AVAILABLE",
              "last_updated":"2024-08-26T14:57:43.000Z",
              "connectors": [
                {
                  "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC0wMjox",
                  "cpoId":"1",
                  "typeId":"33",
                  "maxPowerLevel":350
                }
              ]
            },
            {
              "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC01MA",
              "cpoId":"200104-50",
              "cpoEvseEMI3Id":"200104-50",
              "state":"AVAILABLE",
              "last_updated":"2024-08-25T23:08:53.000Z",
              "connectors": [
                {
                  "id":"ZWNvbW92ZW1lbnQ6MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAzOjIwMDEwNC01MDox",
                  "cpoId":"1",
                  "typeId":"30",
                  "maxPowerLevel":7.2
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

重要なレスポンスフィールド

基本レスポンス内の最も重要なレスポンス要素は、充電ポイントオペレーターの名前、コネクターのタイプ、最大電力レベルです。

上記の例では、以下が最初のコネクターグループのレスポンス要素です。

EV充電ポイントオペレーターの名前："Electrify America"

フィールドextended.evStation.connectors[0].supplierName
最大電力レベル (キロワット単位)：50

フィールドextended.evStation.connectors[0].maxPowerLevel
使用可能なコネクターの数：1

フィールドextended.evStation.connectors[0].chargingPoint.numberOfAvailable

コネクタータイプの名前 (およびID)："JEVS G 105 (CHAdeMO)"("29")

フィールドextended.evStation.connectors[0].connectorType

コネクタータイプIDの数字は変わりませんが、名前は時間の経過とともにわずかに変わる可能性があります。開発者がコネクター情報を使用してレスポンスの詳細を後処理で絞り込む必要がある場合は、名前ではなくIDの使用を検討してください。

ID	説明	注
5	家庭用プラグ/ソケットタイプB (NEMA 5-15)
6	家庭用プラグ/ソケットタイプB (NEMA 5-20)
7	家庭用プラグ/ソケットタイプD (BS 546(3ピン))
8	家庭用プラグ/ソケットタイプE (CEE 7/5)
9	家庭用プラグ/ソケットタイプF (CEE 7/4(Schuko))
10	家庭用プラグ/ソケットタイプE+F (CEE 7/7)
11	家庭用プラグ/ソケットタイプG (BS 1363、IS 401および411、MS 58)
12	家庭用プラグ/ソケットタイプH (SI 32)
13	家庭用プラグ/ソケットタイプI (AS/NZS 3112)
14	家庭用プラグ/ソケットタイプI (CPCS-CCC)
15	家庭用プラグ/ソケットタイプI (IRAM 2073)
20	家庭用プラグ/ソケットタイプK (セクション107-2-D1)
21	家庭用プラグ/ソケットタイプO (タイTIS 166 - 2549)
22	家庭用プラグ/ソケットタイプL (CEI 23-16/VII)
23	家庭用プラグ/ソケットタイプM (南アフリカ15 A/250 V)
24	家庭用プラグ/ソケットタイプIEC 60906-1 (3ピン)
25	AVCONコネクター
29	JEVS G 105 (CHAdeMO)
30	IEC 62196-2タイプ1	通称「SAE J1772」
31	IEC 62196-2タイプ2	通称「タイプ2」
32	IEC 62196-2タイプ3c (SCAME)
33	IEC 62196-3タイプ1コンボ	通称「CCS1」
34	IEC 62196-3タイプ2コンボ (Mennekes)	通称「CCS2」
35	IEC 60309：産業用P + N + E (AC)	産業用コネクター単相16アンペア (CEE、通常は青)
36	IEC 60309：産業用3P + E + N (AC)	産業用コネクター三相16アンペア (CEE、通常は赤)
37	IEC 60309：産業用2P + E (AC)
42	家庭用プラグ/ソケットタイプJ (SEV 1011) (T13、T23)
43	Teslaコネクター	通称「NACS」(北米充電規格)
46	IEC 60309：産業用2P + E (DC)
48	家庭用プラグ/ソケットタイプA (NEMA 1-15、2ピン)
49	家庭用プラグ/ソケットタイプC (CEE 7/17、2ピン)
50	IEC 62196-2タイプ3a (SCAME)
52	GB/T (中国) ACコネクター
53	GB/T (中国) DCコネクター

📘
注
アプリケーションは、EV充電スポットの属性は必須ではないという事実に対応する必要があります。

コネクターの利用状況

EVステーションコネクターの利用状況は、evStationsとevAvailabilityの両方のレスポンス要素にあります。

evStationのグループの利用状況は、特定のタイプのコネクターが使用可能かどうかを表示するのに役立ちます。

evAvailabilityの詳細な利用状況を使用して空いている充電機器を見つけることができます。

グループの利用状況

レスポンス要素evStationは、コネクターグループの利用状況に関する次の情報で強化されています。

lastUpdateTimestamp：コネクターグループ統計の最後の更新日時
numberOfAvailable：前回の更新時に使用可能なコネクターの数
numberOfInUse：前回の更新時に使用可能で使用中のコネクターの数

上記の例では、グループコネクターの利用状況は次のように表示されます。

最初のグループ：1/1 コネクター CHAdeMO は 2023-09-25 09:59:17 から利用可能です
2 番目のグループ：3/3 コネクター IEC 62196-3 タイプ 1 コンボは、最新の 2023-09-25 10:24:18 から利用可能です
3 番目のグループ：1/1コネクターIEC 62196-3タイプ1コンボは、2023-09-20 14:59:22から利用可能です

詳細な利用状況

EV充電スポットの詳細は、eMI3/OCPI業界標準に基づいています。

コネクターは関連するEV供給機器 (EVSE) に関連付けられており、通常、EVSEは独自の駐車スロットに関連付けられています。EVSEの数は、そのステーションで同時に充電できる電気自動車の総数です。

レスポンス要素evAvailabilityには、次の情報が含まれます。

ステーションおよび EVSE の充電ポイントのオペレーター ID：
- extended.evAvailability.stations[].cpoId：CPO 位置 ID
- extended.evAvailability.stations[].evses[].cpoEvseEMI3Id：EVSE ID。このIDはグローバルに一意です。
- extended.evAvailability.stations[].evses[].cpoId：CPOシステムのEVSE識別子。
外部参照用にevses[].cpoIdパラメーターとevses[].cpoEvseEMI3Idパラメーターの両方を使用できます。

EVSEの動作のstateとその関連コネクター

名前	注
`AVAILABLE`	EVSEまたはコネクターは新しい充電セッションを開始できます。
`UNAVAILABLE`	EVSEまたはコネクターは、車などの物理的な障害物により使用できません。
`OCCUPIED`	EVSEまたはコネクターは使用中です。
`OUT_OF_SERVICE`	EVSEまたはコネクターは現在故障しています。
`RESERVED`	EVSEまたはコネクターは特定のEVドライバー用に予約されており、他のドライバーは使用できません。
`OFFLINE` または `OTHER`	ステータス情報がありません(オフライン時にも使用されます)。

それらの状態のlast_updated日時。

eMobilityサービスプロバイダー

eMobilityサービスプロバイダー (eMSP) は、電気自動車 (EV) 充電ローミングサービスを提供する企業または組織です。

EVローミングを使用すると、電気自動車のドライバーはさまざまな参加充電ネットワークで充電サービスを利用できます。 eMSPはEV充電の請求および支払いサービス、テクニカルサポート、カスタマーサービスを提供します。

show=eMobilityServiceProvidersでは、顧客がEVローミングの詳細をextended.evStationに追加できます。

詳細はeMSPのnameとpartner_idで構成されています。partner_idを使用して、優先eMSPプロバイダーの検索結果に絞り込むこともできます。

たとえば、上の例のElectrify America充電スタンド (150 Harrison Ave) では、eMobilityサービスプロバイダーのパートナーIDは2d6b7068-cca5-11ed-b653-42010aa40002です。

 GET https://lookup.search.hereapi.com/v1/
    lookup
    ?id=here:pds:place:evcp0-MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAz
    &show=eMobilityServiceProviders
-H 'Authorization: Bearer{YOUR_TOKEN}'

{
    "title": "Electrify America",
    "id": "here:pds:place:evcp0-MmU4ZjA5OGMtYThmOC0xMWViLWJlMmEtNDIwMTBhODQwMDAz",
  ...
    "extended": {
      "evStation": {
        "access": "public",
        "eMobilityServiceProviders": [{ "name": "Electrify America", "partnerId": "2d6b7068-cca5-11ed-b653-42010aa40002" }]
      }
    }
  }

📘
注
EV充電ポイントの詳細については、EV充電ポイントのドキュメントを参照してください。

EV Charge Points API v3からは、追加の詳細かつ排他的なEV充電ポイント属性を取得できます。詳細については、EV Charge Points API v3のドキュメントを参照してください。HERE Geocoding and SearchとEV Charge Points APIはバックエンドデータベースと場所IDを共有しているため、シームレスに統合される点に注意してください。