HERE Places (Search) API から HERE Geocoding and Search v7 に移行します

HERE Geocoding and Search v7 では、主要施設のカバレッジが向上し、データの更新間隔が長くなります。 さらに、 HERE Geocoding and Search v7 では、「 HERE Places (Search) API 」および「 HERE Geocoder API 」製品の機能を統合したシンプルな API が提供されます。

HERE Places (Search) API は現在メンテナンス中です。

このドキュメントでは、以下の短い名前を使用します。

  • 「 HERE Places (Search) API 」の「 Places API 」
  • 「 HERE Geocoding and Search v7 」の場合は「 GS7 」

変更の概要

移行を完了するには、次の一般的なアクションを実行する必要があります。

注

概念の変更により、サポートされなくなった入力および出力パラメーターがあります。 これらについては、このガイドで詳しく説明します。

命名

Places API と GS7 では、同じような概念で異なる名前が使用されます。

Places API GS7. メモ
" エントリーポイント " " サービス " 以下のエントリーポイントからサービスまでを参照してください
" リソース " " エンドポイント "
エントリーポイント " パラメーター " エンドポイントクエリ " パラメータ "
" メディアタイプ " " 応答エレメント "
メディアタイプ " 属性 " " 応答エレメント "

基本 URL

Places API は、ターゲットセグメントと承認方法の両方に応じて、 URL 経由でアクセスできます。

基本 URL バリアント 承認方法
https://places.ls.hereapi.com 公共、自動車 OAuth2 または API キー
https://places.api.here.com 公開 app_id/app_code
https://places.cc.api.here.com 自動車関連 app_id/app_code

GS7 関連の URL は、ターゲットセグメントや承認方法ではなく、 HERE platform 「サービス」の一般的な概念に基づいています。 「サービス」とは、 Places API で「エントリーポイント」として知られているものを指します。

HERE platform サービスのドメイン名はスキーマに準拠 [service].[product].hereapi.comしています。

GS7 製品の一部 searchhttps://[service].search.hereapi.comであるため、移行するベース URL はスキーマに従います。

GS7 には Places API エントリーポイントに対応する 4 つのサービスがあります。 検出、参照、自動候補提示、および検索があります。 すべてのサービスは、 OAuth トークンまたは API キー のいずれかを介して承認されます。 のベース URL は次のとおりです。

基本 URL サービス 承認方法
https://autosuggest.search.hereapi.com 自動候補提示サービス OAuth2 または API キー
https://discover.search.hereapi.com サービスの検索 OAuth2 または API キー
https://browse.search.hereapi.com サービスを参照します OAuth2 または API キー
https://lookup.search.hereapi.com 検索サービス OAuth2 または API キー

エントリーポイントからサービスへ

以下のマッピングは、 Places API エントリーポイントが GS7 サービスにどのように対応するかを要約したものです。

Places API エントリーポイント GS7 同等です ステータス コメント
自動候補提示エントリーポイント 自動候補提示サービス 利用可能です
エントリーポイントを検索します サービスの検索 利用可能です
エントリーポイントを参照します サービスを参照します 利用可能です
エントリーポイントを検索します 検索サービス 利用可能です
エントリーポイントを探索します サービスを参照します 一部 Places API エントリーポイントに匹敵するサービスは現在利用できません。
GS7 ブラウズサービスでは、お客様のニーズを満たすことができますので、ご了承ください。
そうでない場合は、 GS7 マネジメントに連絡してください。
Corridor エントリーポイントでブラウズ サービスを参照します 利用可能です
エントリーポイントを提案します 自動候補提示サービス 利用可能です Suggest エントリーポイントは Places API で廃止されました。 エントリーポイントの完成度を参照してください
HERE エントリーポイント サービスを参照します 利用可能です HERE エントリーポイントは Places API で廃止されました。 エントリーポイントの完成度を参照してください
エントリーポイント周辺 サービスを参照します 利用可能です Around エントリーポイントは Places API で廃止されました。 エントリーポイントの完成度を参照してください
カテゴリエントリーポイントを配置します 現在利用できません 「場所」カテゴリと同等の GS7 サービスは現在利用できません。 GS7 でサポートされている場所のカテゴリの詳細については、開発者ガイドのカテゴリリストを参照してください。
料理のカテゴリーエントリーポイント 現在利用できません 現在のところ、飲食店に匹敵する GS7 サービスは提供されていない。 「開発者ガイド」のフードタイプリストでは、 GS7 がサポートするレストランの料理について詳しく説明しています。
Actions エントリーポイント（アクションの設定 現在利用できません
Health エントリーポイント ( 健康管理 ) 現在利用できません
Corridor Shortener エントリーポイント ( なし ) 範囲外です 開発者ガイドで説明されている単純化
browse-pt-stops エントリーポイントを参照します ( なし ) 範囲外です HERE Public Transit API を使用してください 。

パス

技術的には、 API エントリーポイントおよび GS7 サービスはそれぞれ REST API エンドポイントリソースにマップされます。 以下は、両方の製品で使用されているさまざまなエンドポイントリソースパスのサブセットです。

製品 エントリーポイント APIBase
URL を配置します		 APIVersion を配置します
 APIResource
パスを配置します
Places API 検索 https://places.ls.hereapi.com(*) /places/v1 /discover/search
Places API Autosuggest https://places.ls.hereapi.com(*) /places/v1 /autosuggest
Places API Browse https://places.ls.hereapi.com(*) /places/v1 /browse
Places API 検索 https://places.ls.hereapi.com(*) /places/v1 /lookup
製品 サービス GS7Base
URL		 GS7 バージョン
 GS7 エンドポイント
パス
GS7. Autosuggest https://autosuggest.search.hereapi.com /v1 /autosuggest
GS7. Disco https://discover.search.hereapi.com /v1 /discover
GS7. Browse https://browse.search.hereapi.com /v1 /browse
GS7. 検索 https://lookup.search.hereapi.com /v1 /lookup

(*) および https://places.api.here.comhttps://places.cc.api.here.com。

「」に一致する結果は 件です

    「」に一致する結果はありません