ガイドAPIリファレンス変更履歴
ガイド

ハイライト

新機能および拡張機能の詳細については、「新機能」を参照してください。

リリース7.147、2025年12月

Signals:新しい/signalsエンドポイントをRESTRICTED機能として追加しました。

リリース7.147、2025年11月

すべてのエンドポイント:HERE Geocoding and Searchは、ポルトガルの住所と場所の結果に対し、Postal Addressing製品の7桁の郵便番号のみを使用するようになりました。通りや地域の結果に対して、HERE Geocoding and Searchは4桁の「地域」郵便番号を返します。郵便番号が7桁のみのクエリでは、タイプがpostalCodePointの結果が返されるようになりました。4桁の「地域」郵便番号のクエリでは、タイプがlocality(localityType=postalCode)の結果が返されます。

リリース7.146、2025年10月

すべてのエンドポイント:HERE Geocoding and Search API v7は、郵便番号のみのクエリに対するサポートを改善しました。台湾とイスラエルでpostalCodePointの結果を追加しました。マン島のカバレージを拡大しました。英国では北アイルランドにカバレージを拡大し、米国、カナダ、オランダ、イギリスのその他の地域でのカバレージも拡大しました。Reverse Geocoderは引き続き一部の国でのみpostalCodePointの結果を返しますが、今回のリリースではそのカバレージがわずかに拡大しました。

Autosuggest、Browse、Discover、Lookupshow=truckオプションを使用すると、許可されたお客様は、次のような利用可能なトラックアメニティに関する詳細を取得できます。carWashchemicalToiletDisposalhighCanopyidleReductionnightParkingOnlypaidParkingparkingpowerSupplyreservableParkingsecureParkingtruckScalestruckServicetruckStoptruckWashwifi

Autosuggest、Browse、Discover、Lookupshow=fuelオプションを使用すると、許可されたお客様は、ガソリンスタンドの結果で燃料タイプの詳細を取得できます。show=fuelPricesオプションを使用すると、許可されたお客様は、ガソリンスタンドの結果で燃料価格を取得できます。

AutoSuggest、Browse、DiscoverfuelStationオプションを使用すると、許可されたお客様は、ガソリンスタンドの結果にいくつかの制約を設定できます (たとえば、ディーゼルのみ、またはE5/E10燃料タイプのみを提供するなど)。

Geocode、Lookup、Reverse Geocode、Multi-Reverse Geocode: 住所に属性を追加し、その住所が居住用か、商業 (ビジネス)用かをshow=addressUsasgeパラメーターで識別できるようになりました。注:この機能はALPHA版としてリリースされ、許可されたお客様のみにアクセスが制限されています。

リリース7.143、2025年9月

Discover、Browse、Lookupshow=tripadvisorImageVariantsパラメーターを含むクエリでは、さまざまなサイズの画像URLが返されるようになりました。

リリース7.135、2025年3月

Geocode、Reverse GeocodeshowRelated=intersections安定版としてリリースされます。

すべてのエンドポイント: HERE Geocoding and Search API v7は、「住宅用エリア/建物」カテゴリーを「建物名」とする建物のフットプリントと場所のデータを統合することで、香港の建物名のカバレージを大幅に拡大しました。すべてのHERE Geocoding and Search API v7エンドポイントは、関連する建物名を持つ住所に対して、住所結果の一部として建物名を返します。

さらに、/geocodeエンドポイントは香港の建物名に対する包括的なサポートを提供します。建物名で住所を検索できます。あいまいさを避けるため、クエリに道路名や行政名、または空間的文脈を別途含めることをお勧めします。

Geocode: 台湾の大部分の道路命名には階層モデルが採用されており、主要道路には説明的な名称 (例:Yuan Dong Rd.) が付けられ、その長さ沿いに複数の区間に分割されることがあります (例:Sec 2, Yuan Dong Rd.)。これらの主要道路と交差する生活道路は、セクション番号を含めてメイン道路と同じ名前で、追加のレーン番号が付けられています (例:Lane 423, Sec 2, Yuan Dong Rd.)。生活道路と車線が交差する道路には、さらに路地番号が付きます (例:Alley 31, Lane 423, Sec 2, Yuan Dong Rd.)。/geocodeエンドポイントはこの階層モデルをサポートし、正しい路地/lane/sectionでの結果を優先します。この場合、セクション部分は省略可能です。正しい道路の住所がマップデータに存在しない場合、ジオコードは正しい道路での番地フォールバックまたは道路階層の上位階層へのフォールバックにより、間違った路地/lane/sectionの住所結果を優先します。ラテン文字のクエリの場合、ジオコードは路地/lane/section部分の形式と順序の柔軟性をサポートします。

リリース7.134、2025年2月

すべてのエンドポイント:カナダでは、郵便規則に従った住所表記で使用される地域名は、行政上の都市名と異なる場合があります。HERE Geocoding and Search APIレスポンスでの「住所」ブロック内の名前は、行政的な視点に基づいています。

結果のタイトルと住所ラベルがローカルユーザーにとって認識可能で正確なものになるように、HERE Geocoding and Search API v7は、これらのフィールドに郵便市区町村名を含めるようになりました。

  • 結果タイトル - 次のHERE Geocoding and Search API v7エンドポイントでは、カナダのロケーションの結果タイトルに郵便市区町村名が表示されます:Geocode、Reverse Geocode、Lookup、Discover、Autosuggest、Browse。適用される結果タイプ: houseNumberpostalCodePointstreetintersection。(場所の結果には、タイトルに行政名が含まれないことに注意してください)

  • 住所ラベル - 次のHERE Geocoding and Search API v7エンドポイントでは、カナダの住所ラベルに郵便市区町村名が使用されます:Geocode、Reverse Geocode、Lookup、Discover、Autosuggest、Browse、Autocomplete。適用される結果タイプ:houseNumberpostalCodePointstreetintersectionplace

  • 住所ブロック - 住所ブロック内の都市名には、常にHERE Map Contentの行政上の都市名が反映されます。その結果、住所の都市名がラベルおよびタイトルと異なる場合があります。

リリース7.131、2024年12月

Geocode:リバースジオコードエンドポイントのベータ機能showRelated=intersectionsに、resultType=houseNumberまたはresultType=streetを指定した結果アイテムに対して、住所に最も近い交差点のリストを含むブロックを含める機能が、/geocodeエンドポイントに拡張されました。

リリース7.130、2024年11月

日本の大半のEV充電スポットは、一般的なラベル (EV充電スタンド) と比較して区別しやすくするために、独自のポイント名に名称が変更されています。 Geocode、Autocomplete:機能postalCodeMode=cityLookuppostalCodeMode=districtLookupの既知の軽微な問題がすべて修正されました。これらの機能はベータ版から安定版に昇格されました。

Reverse Geocode、Multi-Reverse Geocode:機能showRelated=nearbyAddress安定版に昇格しました。

Geocode/geocodeエンドポイントにより、レスポンスに正規化された住所フィールドまたは一致した住所フィールドを表示するかを選択できるようになりました。この設定は、住所ブロック内の名前、住所ラベル、結果タイトルにも影響します。このオプションは、管理上の命名規則と郵便番号または一般的な命名規則との間に違いがある場合に関係します。デフォルトでは、ジオコーディングの結果には、管理場所に一致する名前が表示され、道路名に正規化された (正式な) 名前が表示されます。この機能は、パラメーターaddressNamesMode=normalizedによって有効にできます。

リリース7.129、2024年10月

Browse、Discover、Lookupshow=evおよびshow=eMobilityServiceProvidersクエリパラメーターは、HERE基本プランのサブスクリプションに登録しているすべてのお客様が使用できます。

Autosuggest、Discover、Browse:evStation[*]フィルターは、HERE基本プランのサブスクリプションに登録しているすべてのお客様が使用できます。

リリース7.128、2024年10月

Browse、Discover、Lookupshow=evおよびshow=eMobilityServiceProvidersクエリパラメーターは、軽量車両のEVステーション (カテゴリーID700-7600-0322)、トラック (カテゴリーID 700-7600-0323)、2輪車 (カテゴリーID700-7600-0324) の拡張詳細を返すようになりました。

Autocomplete:郵便番号が複数の都市区域と関連付けられている地域について、autocompleteエンドポイントpostalCodeMode=cityLookupの複数結果返却機能が、地区行政レベルまで拡張されました。郵便番号が複数の地区(同一都市内または複数の都市)にまたがる場合、postalCodeMode=districtLookupを使用すると、autocompleteエンドポイントは、郵便番号に対応する地区名と都市名のすべての組み合わせを返します。

📘

この機能はベータ版としてリリースされます。

Geocode:ジオコードエンドポイントで、郵便番号が複数の地区 (postalCodeMode=districtLookup) または都市 (postalCodeMode=cityLookup) と関連付けられている地域で複数の結果を返すオプションが追加されました。これらのオプションを指定しない場合、システムは1つの結果のみを返し、地区や都市名を空白にしたりデフォルト名を使用したりするため、関連する地区や都市が省略される可能性があります。この機能は、パラメーターpostalCodeModeによって有効にできます。サポートされている値はcityLookupdistrictLookupです。

📘

この機能はベータ版としてリリースされます。

Geocode: 認識されたユニット指定子(例:スイートやフロア)に対して、/geocodeエンドポイントが正規化されたユニットタイプとユニット値を含む追加のブロックを返すオプションを提供します。現在サポートされている国:CAN、USA。

この機能は既存の機能を拡張して、クエリ内の解析ブロック内の認識されたセカンダリユニット情報を「そのまま」表示します。この機能はshow=secondaryUnitInfoパラメーターで有効化されます。

リリース7.127、2024年9月

AutoSuggest、Browse、Discoveroffsetクエリパラメーターによるページネーションをアルファ版機能として追加しました。

リリース7.126、2024年8月

Geocode、Reverse Geocode、Multi-Reverse Geocode、LookupshowNavAttributes=speedLimits安定版としてリリースされました。

AutoSuggest、Browse、Discoveroffsetクエリパラメーターによるページネーションをアルファ版機能として追加しました。

リリース7.125、2024年8月

HERE Geocoding and Search API v7でベトナムの行政分類が改善されました。

リリース7.124、2024年7月

AutoSuggest、Browse、Discover: http POST メソッドのサポートが RESTRICTED BETA 機能に昇格しました。

AutoSuggest、Browse、Discover: ルート パラメーターと ranking=excursionDistance パラメーターの両方を含むリクエストの結果では、ルート ポリラインからの距離を昇順で並べ替えます。この機能を使用すると、ルート全体から結果を得ることができます。これはベータ機能です。

リリース 7.123、2024 年 7 月

Geocode、Lookup:オーストラリア、カナダ、ニュージーランド、米国、プエルトリコでのマイクロポイント住所(MPA)のサポートがALPHAからSTABLEに昇格しました。

📘

この機能は引き続きRESTRICTEDです。

リリース7.122、2024年6月

代替道路名のサポート HERE Geocoding and Search API v7で、代替道路名を使用したアドレス指定がサポートされるようになりました。道路に複数の名前が付いている場合、HERE Geocoding and Search API v7はそのいずれかの道路名を使用して住所を特定できます。

優先される名前:明確でない場合、HERE Geocoding and Search API v7は結果で「公式」の道路名を優先します。この名前はマップデータの住居番号に関連付けられた名前です。

GeocodeDiscoverAutosuggest エンドポイントは、「公式」の細街路名を含む住所を返します。

DiscoverAutosuggest エンドポイントの場合、括弧書きで一致する細街路名も含めます。

Autocomplete エンドポイントは、引き続き一致する細街路名を含む住所を返します。

サポートされている国:オーストラリア、ブラジル、インドネシア、オランダ、ポーランド、ポルトガル、ルーマニア、スロバキア、米国。

📘

この機能は、バージョン7.108から米国で利用できるようになりました。

リリース7.114、2023年12月

日本向けに EV 充電ポイント ステーションの検索を追加しました。

リリース 7.113、2023 年 11 月

Multi-Reverse Geocoder エンドポイントが一般向けにリリースされました。

Geocode、Lookup:オーストラリア、ニュージーランド、米国で、マイクロ ポイント住所 (MPA) が RESTRICTED ALPHA としてサポートされるようになりました。

マイクロポイント住所はポイント住所の建物、フロア(階数)、スイート(ユニット)といった補助的な住所を表します。/geocodeエンドポイントは、クエリのセカンダリユニット情報を照合し、type=houseNumberと新しく導入されたhouseNumberType=MPAを含む結果を返すようになりました。MPAの結果は特定のユースケースでのみ必要とされ、すべてのアプリケーションが使用するわけではないため、この機能はwith=MPAのパラメーターを使用して有効にする必要があります。/lookupエンドポイントでは、追加パラメーターを使用することなくIDでMPA結果を返すことができます。

/geocode/lookupエンドポイントでは、新たにshowRelatedパラメーターがサポートされ、指定可能な値はMPAparentPAです。これにより、type=houseNumberhouseNumberType=PAの結果項目に関連するすべてのMPAをリスト表示できるようになりました。また、type=houseNumberhouseNumberType=MPAの結果項目について親のPAをリスト表示できます。

リリース7.109、2023年9月

Multi-Reverse Geocoderエンドポイントがアクセス制限付きでリリースされました。HERE Geocoding and Search API v7 /multi-revgeocodeエンドポイントは、Reverse Geocodingリクエストのスループットパフォーマンスを向上させるように設計されています。エンドポイントでは、1回のマルチリバースジオコーディングのリクエストで最大100か所の位置のアドレスを取得できます。新しいエンドポイントの使用にご関心がある場合は、担当の営業アカウント マネージャーにお問い合わせください。

リリース 7.106、2023 年 6 月

移動方向 (位置トラック) を考慮することにより、道路マッチングの精度が向上しました。新しい「方位」パラメーターは、アセットの方向を度数で表します。真北から始まり、コンパスの周りを時計回りに進みます。値の範囲は 0 度 (北) から 359 度 (北に戻る直前) です。参考までに、東は 90 度、南は 180 度、西は 270 度に対応します。bearing パラメーターには、[0;359] の範囲内の整数値のみ使用できます。他の値を指定すると、400 エラー レスポンスが返されます。機能の成熟度レベルはベータです。

リリース 7.98、2023 年 2 月

Autocompleteをリリースしました。HERE Geocoding and Search API v7 /autocompleteエンドポイントはベータ版ではありません。エンドポイントは一般利用が可能となり、完全なサポートが行われます。

/autocomplete エンドポイントは、住所または行政区画の一部を入力すると自動的に入力を完了させ、住所の入力を高速化します。該当する提案を選択すると、カスタマー アプリケーションは /lookup エンドポイントを使用して、提案された結果の地理座標を取得できます。