はじめに - HERE Developer ポータル
注 : このセクションで は、 EV 充電ステーション API の使用を迅速に開始するために必要な最小限の設定について説明します。HERE アカウントの設定、プロジェクトの作成、サービスのリンク、アプリの登録、および認証の詳細については、 ID およびアクセス管理開発者ガイドを参照してください。
HERE アカウントを取得
If you are an individual developer who has signed up for one of the plans listed on our Developer plans page on here-tech.skawa.fun, you received a HERE account ID when you signed up. You can use your HERE account to log in to here-tech.skawa.fun to create applications. Applications (uniquely identified by an app ID) enable development with HERE products and services.
新しいプロジェクトを作成します
新しいプロジェクトを作成するには、次の手順に従います。
- HERE platform の platform.here.comusingYour HERE アカウントにサインインします。
- ランチャからプロジェクト管理者を開きます。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ～ 16 文字である必要があります。
- 任意の説明を入力する。
- [保存]をクリックする。
注 : EV 充電ポイント API サービスをプロジェクトにリンクする必要はありません。 デフォルトの設定では、サービスへのアクセス権が付与されます。
API キー を入手してください
API キー を取得するには、次の手順を実行します。
- Sign in to here-tech.skawa.fun.
- 名前をクリックし 、 [ プロジェクト] を選択して、一覧からプロジェクトを選択します。 プロジェクトの詳細と利用可能なアプリケーションの資格情報が表示されます。
- API キー を作成をクリック して、アプリケーションに最大 2 つの API キーを生成します。 API キー が作成され、表示されます。
bearer トークン を取得します
ベアラトークンの詳細について は、『 Identity & Access Management 開発者ガイド 』を参照してください。
リクエストを送信します
このセクションでは、指定した検索ジオメトリ内のチャージステーションのリストに対するリクエストの例を示します。
この例では、 IEC 62196-2 type 2 (Mennekes) ドイツのベルリンにある緯度 52.516667 および経度 13.383333 から 5 km 以内に電気自動車用のコネクタを備えた充電スタンドを探しています。 緯度および経度の値は WGS 84 形式です。
次のコードブロックは、応答データがベアラートークン を使用して JSON で配信されるように指定する、完全な要求を示しています。
GET
https://ev-v2.cc.api.here.com/ev/stations.json
?prox=52.516667,13.383333,5000
&connectortype=31
-H 'Authorization: Bearer{YOUR_TOKEN}'
次のコードブロックは、 API キー を使用して JSON で応答データを配信することを指定して、リクエスト全体を示しています。
GET
https://ev-v2.cc.api.here.com/ev/stations.json
?prox=52.516667,13.383333,5000
&connectortype=31&apiKey={YOUR_API_KEY};
次のコードブロックは同じリクエストですが、応答データがベアラートークン を使用して XML で配信されることを示します。
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000
&connectortype=31
-H 'Authorization: Bearer{YOUR_TOKEN}'
次のコードブロックは同じリクエストですが、応答データが API キー を使用して XML で配信されることを示しています。
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000
&connectortype=31&apiKey={YOUR_API_KEY};
リクエストに対する応答には、次の内容が含まれます。
- 充電ステーションに関する情報。
- 充電ステーションのコネクタに関する情報。
- チャージステーションのコネクタに関する詳細情報。
JSON 形式の応答例は次のとおりです。
{
"hasMore": true,
"count": 50,
"evStations": {
"evStation": [
{
"poolId": "276u33db845jn-aGVyZS1ldjplY29tb3ZlbWVudDo4OTU5MDU0ODI",
"totalNumberOfConnectors": 2,
"connectors": {
"connector": [
{
"supplierName": "RWE eRoaming",
"connectorType": {
"name": "IEC 62196-2 type 2 (Mennekes)",
"id": "31"
},
"chargeCapacity": "380-480VAC, 3-phase at max. 32 A",
"maxPowerLevel": 22.08,
"customerChargeLevel": "3",
"customerConnectorName": "AC EV connector (Mennekes - type 2)",
"fixedCable": false,
"connectorDetails": {
"privateAccess": false,
"open24x7": true,
"openingHours": {
"regularOpeningHours": [
{
"daymask": 127,
"period": [
{
"from": "00:00:00",
"to": "24:00:00"
}
]
}
],
"annualOpenings": [ ]
},
"pay": true,
"manufacturer": "RWE"
},
"chargingPoint": {
"chargeMode": "3",
"voltsRange": "380-480V AC",
"phases": 3,
"ampsRange": "32A",
"numberOfConnectors": 2
}
}
]
},
"evStationDetails": {
"privateAccess": false,
"restrictedAccess": true,
"accessibilityType": "RESTRICTED",
"paymentMethods": {
"subscription": {
"provider": "RWE eRoaming",
"accept": true
},
"note": "Mobile Payment Option Available"
},
"notes": "Ladestation RWE Effizienz GmbH"
},
"address": {
"city": "Berlin",
"country": "DEU",
"region": "Berlin",
"street": "Luisenstraße",
"streetNumber": "31",
"postalCode": "10117"
},
"contacts": {
"phone": [
{
"value": "+498002255793",
"label": "PHONE"
}
]
},
"distance": 421,
"position": {
"latitude": 52.5199013,
"longitude": 13.3800898
},
"name": "RWE Effizienz GmbH",
"id": "276u33db-b2c840878cfc409fa5a0aef858419037",
"lastUpdateTimestamp": "2015-08-28T04:39:27.737Z",
"timeZone":"Europe/Berlin"
},
{
--- removed to shorten document
}
]
}
}
XML 形式の応答例は次のとおりです。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ev:evStationsResult xmlns:fuel="http://www.here.com/2014/02/ACS-Fuel" xmlns:common="http://www.here.com/2014/02/ACS-Common" xmlns:ev="http://www.here.com/2014/02/ACS-EV" xmlns:parking-offstreet="http://www.here.com/2014/02/ACS-Parking-Offstreet">
<hasMore>true</hasMore>
<count>50</count>
<evStations>
<evStation id="276u33db-b2c840878cfc409fa5a0aef858419037" lastUpdateTimestamp="2015-08-28T04:39:27.737Z" timeZone="Europe/Berlin">
<address>
<city>Berlin</city>
<country>DEU</country>
<region>Berlin</region>
<street>Luisenstraße</street>
<streetNumber>31</streetNumber>
<postalCode>10117</postalCode>
</address>
<contacts>
<phone>
<value>+498002255793</value>
<label>PHONE</label>
</phone>
</contacts>
<distance>421</distance>
<position>
<latitude>52.5199013</latitude>
<longitude>13.3800898</longitude>
</position>
<name>RWE Effizienz GmbH</name>
<poolId>276u33db845jn-aGVyZS1ldjplY29tb3ZlbWVudDo4OTU5MDU0ODI</poolId>
<totalNumberOfConnectors>2</totalNumberOfConnectors>
<connectors>
<connector>
<supplierName>RWE eRoaming</supplierName>
<connectorType>
<name>IEC 62196-2 type 2 (Mennekes)</name>
<id>31</id>
</connectorType>
<chargeCapacity>380-480VAC, 3-phase at max. 32 A</chargeCapacity>
<maxPowerLevel>22.08</maxPowerLevel>
<customerChargeLevel>3</customerChargeLevel>
<customerConnectorName>AC EV connector (Mennekes - type 2)</customerConnectorName>
<fixedCable>false</fixedCable>
<connectorDetails>
<privateAccess>false</privateAccess>
<open24x7>true</open24x7>
<openingHours>
<regularOpeningHours>
<daymask>127</daymask>
<period>
<from>00:00:00</from>
<to>24:00:00</to>
</period>
</regularOpeningHours>
</openingHours>
<pay>true</pay>
<manufacturer>RWE</manufacturer>
</connectorDetails>
<chargingPoint>
<chargeMode>3</chargeMode>
<voltsRange>380-480V AC</voltsRange>
<phases>3</phases>
<ampsRange>32A</ampsRange>
<numberOfConnectors>2</numberOfConnectors>
</chargingPoint>
</connector>
</connectors>
<evStationDetails>
<privateAccess>false</privateAccess>
<restrictedAccess>true</restrictedAccess>
<accessibilityType>RESTRICTED</accessibilityType>
<paymentMethods>
<subscription accept="true">
<provider>RWE eRoaming</provider>
</subscription>
<note>Mobile Payment Option Available</note>
</paymentMethods>
<notes>Ladestation RWE Effizienz GmbH</notes>
</evStationDetails>
</evStation>
<evStation id="276u33db-822fe7352e204e36b733275c62e2ec4e" lastUpdateTimestamp="2015-08-28T08:53:33.834Z" timeZone="Europe/Berlin">
--- removed to shorten document
</evStation>
</evStations>
</ev:evStationsResult>
次のステップ
このドキュメントに適用される利用規約につきましては、「HERE Documentation License」を参照してください。
