利用開始
このセクションでは、路上駐車場 API を使用してすばやくはじめに を作成する方法について説明します。On-Street Parking API を使用するには、 REST リクエストの HTTP 承認ヘッダに、ベアラートークン としてトークン を入力する必要があります。
- HERE アカウントを取得
- プロジェクトを作成
- OAuth トークンの入手
- リクエストを送信
注
このセクションでは、オンロードパーキング API を使用して迅速に作業を開始するために必要な最小限の設定について説明します。HERE アカウントの設定、アプリ の登録、および認証の詳細について は、『 ID およびアクセス管理ガイド』を参照してください。
On-Street Parking API は、車載用途の自動車 OEM のみが利用できます。 On-Street Parking API で認証を受ける前に、 HERE の担当者に連絡してください。
HERE アカウントの取得
On-Street Parking API の使用を開始するには、組織管理者に連絡して、会社に設定されている HERE platform 組織に参加するよう招待してください。
プロジェクトを作成
プロジェクトを作成するには、次の手順に従います。
- HERE アカウントを使用して HERE platform にサインインする。
- ランチャーから[プロジェクトマネージャ]を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- オプション : 説明を入力する。
- [保存]をクリックする。
OAuth トークンの入手
トークン 資格情報 は、ベアラアクセストークンの OAuth 2.0 業界標準プロトコルに準拠しています。 HERE は、 HERE platform への要求を認証する目的で、アプリケーションが最大 24 時間使用できる安全なアクセストークンを取得するための REST API を提供します。 OAuth トークン の入手方法については 、『 ID およびアクセス管理ガイド』を参照してください。
トークン を使用して、 On-Street Parking API リクエストを送信します。
リクエストの送信
以下の例では、スペインのバルセロナにある特定のエリアの駐車場情報を取得する方法について説明します。
HTTP ヘッダーに bearer トークンを含めます。
Authorization: Bearer <token>
次のように GET リクエストを送信します。
https://osp.cc.api.here.com/parking/segments
?bbox=41.389405513925354,2.127549994463742,41.38042236108416,2.139522979169079
bbox
このパラメータでは、検索領域のバウンディング ボックスを指定します。
上記のリクエストに対する応答では、次のハイレベルな要素が提供されます。
- parkingSegments 配列には、リクエストで指定されたバウンディング ボックス のすべての駐車場セグメントが含まれています。このセグメントについては、駐車場の空き状況または駐車規則の情報を参照できます。 各セグメントについて、駐車制限を含む路上駐車場の全情報が提供されます。 詳細については、「駐車セグメント」を参照してください。
{
"parkingSegments":[
{
"id":"192191",
"capacity":8,
"paymentInfo":{
"paymentType":[
"ON_FOOT"
],
"paymentMethod":{
"CARDS":[
"UNKNOWN"
],
"CASH":[
"COINS"
],
"ELECTRONIC_PAYMENT":[
"MOBILE"
]
}
},
"priceSchema":{
"currencyCode":"EUR",
"prices":[
{
"maxStay":"PT2M",
"times":[
{
"days":31,
"timeRange":{
"startTimeOfDay":"08:00",
"endTimeOfDay":"20:00"
}
}
],
"cost":[
{
"type":"NONE",
"amount":2.75,
"duration":"PT1H"
}
]
}
]
},
"address":{
"street":"Carrer de Galileu, 314",
"city":"Barcelona",
"postalCode":"08028",
"countryCode":"ESP"
},
"tpegOpenLR":{
"binary":"CCgBEAAkIwGEFR1t4AAJBQQFA/EACgQDBWAA/9gAUQAJBQQFA3EAMBcL",
"sideOfRoad":"RIGHT"
},
"availability":{
"availableSpots":3,
"trend":"STATIC",
"lastUpdatedTimestamp":"2019-01-21T09:40:03Z"
}
},
{
"id":"6205098",
"capacity":8,
"priceSchema":{
"currencyCode":"EUR",
"prices":[
{
"times":[
{
"days":127,
"timeRange":{
"startTimeOfDay":"00:00",
"endTimeOfDay":"00:00"
}
}
],
"cost":[
{
"type":"NONE",
"amount":0,
"duration":"PT1H"
}
]
}
]
},
"address":{
"street":"Calle de Joan Güell",
"city":"Barcelona",
"postalCode":"08028",
"countryCode":"ESP"
},
"features":[
"MOTORCYCLE"
],
"parkingRestrictions":[
{
"type":"NO_PARKING",
"exceptions":[
{
"type":"MOTORCYCLES_ONLY"
}
]
}
],
"tpegOpenLR":{
"binary":"CCkBEAAlJAGEFB1tZgAJBQQFA3IACgUEBYEjAAA9/3QACQUEBQPzADBmLg==",
"sideOfRoad":"LEFT"
},
"probability":[
{
"probability":31
}
]
}
]
}
次のステップ
API リクエストで使用されているパラメータおよび応答で提供されているデータを記述した On-Street Parking API リファレンスをさらに参照することをお勧めします。