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

機能の成熟度

ほとんどのHERE Geocoding and Search機能はUNRESTRICTEDまたはSTABLE (別称「GA」)状態です。

一部のHERE Geocoding and Search機能には成熟度レベルALPHAまたはBETA、特権レベルRESTRICTEDが付いています。

このような機能は「開発者ガイド」と「APIリファレンス」の両方でタグ付けされています。

成熟度

API リクエスト パラメーターおよびレスポンス フィールドには、次の成熟度修飾子のいずれかがタグ付けされている場合があります:ALPHA、BETA。

  • 「ALPHA」タグが付いた機能は開発の途中段階にあります。変更される場合や、まれに削除される場合があります。後方互換性は保証されておらず、バグのサービスレベル契約(SLA)も適用されません。ALPHA 機能を使用している場合、本番環境では使用しないことをお勧めします。
  • 「BETA」タグが付いた機能は開発の終了段階にあります。このような機能には後方互換性があり、削除されることはありません。重大なバグはないものの、カバレージ、品質、パフォーマンス、テスト カバレージは最終的なものではありません。このような制約と動作が改善される可能性に合意したお客様は、アプリケーションで BETA 機能を安全にご利用いただけます。

特権

API リクエスト パラメーターおよびレスポンス フィールドには、特権修飾子である「RESTRICTED」がタグ付けされている場合があります。このような機能は HEREと特定の契約を結んでいるお客様のみが利用できます。通常、不正に使用するとhttp ステータスコード403となります。

後方互換性がある変更

すべてのHERE Geocoding and SearchのBETAおよびSTABLEでは更新とバグ修正が実装されており、 既存のアプリケーションとの互換性を維持しています。API の動作を大幅に変更するメジャー アップデートは、別の URL でリリースされます。

次のリクエスト インターフェースの変更には後方互換性があります。

  • 新しいエンドポイントの追加
  • 新しい任意パラメーターの追加
  • 新しい列挙値の追加
  • パラメーターの必須から任意への変更
  • パラメーターの制約の緩和

次のレスポンス構造の変更には後方互換性があります。

  • 新しいレスポンス要素の追加
  • 以前の列挙値のセマンティックを変更しない、新しい列挙値の追加
  • 要素を必須から任意へ切り替えたものの、既存のリクエストでは要素が引き続き入力されるもの
  • 新しいエラー サブタイプの追加
  • レスポンス要素値の制約の強化