プレイス ID の使用 - Amazon Location Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プレイス ID の使用

場所を検索すると、結果のリストが返されます。ほとんどの結果には、その結果のPlaceIdが含まれています。GetPlaceオペレーションで PlaceId を使用すると、その場所に関する情報 (名前、住所、場所、その他の詳細を含む) が返されます。

注記

を使用するとSearchPlaceIndexForSuggestions、任意のデータソースで作成された任意の場所インデックスPlaceIdの結果が返されます。SearchPlaceIndexForText または を使用すると、使用するデータソースが HERE であるPlaceId場合にのみ が返されSearchPlaceIndexForPositionます。

それぞれの PlaceId は、それが指す場所を一意に定義するが、一つの場所は、時間の経過とともに、また文脈に応じて、複数の PlaceId が含まれる場合があります。以下のルールは、 PlaceId のユニークさと耐久性を説明するものである。

  • 実行する呼び出しでPlaceId返される は AWS アカウント、、 AWS リージョン、およびPlaceIndexリソース内のデータプロバイダーに固有です。 GetPlaceは、これら 3 つの属性が を作成した元の呼び出しと一致した場合にのみ結果を検索しますPlaceId。

  • PlaceIdという場所に関するデータが変わると、その場所の番号も変わります。例えば、参照するビジネスが所在地を移転したり、名称を変更した場合などです。

  • 繰り返される検索の呼び出しから返されるPlaceIdは、バックエンド・サービスが更新を行ったときに変更される可能性があります。元の PlaceId は引き続き検索されるが、新たに検索を呼び出すと別の ID が返されることがあります。

PlaceIdは文字列です。 PlaceId の長さに特に制限されていません。次は、PlaceId の例です。

AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ

データが変更された場所(例えば、廃業した事業所など)のために PlaceId で GetPlace を呼び出すと、404,ResourceNotFound エラーが発生します。有効でない 、または別の からの など、コンテキスト外の で PlaceIdを呼び出すGetPlaceと AWS アカウント、400ValidationExceptionエラー が返されます。

後続のリクエストで PlaceID を使用できますが、 PlaceID は永続的な識別子ではなく、ID は連続する API コール間で変更される可能性があります。データプロバイダーごとに、次の PlaceID の動作を参照してください。

  • Esri : プレイス IDsは少なくとも四半期ごとに変更されます。これらの変更の一般的な期間は、3 月、6 月、9 月、12 月です。プレイス IDs通常の四半期ごとの変更間で変更されることもありますが、頻度ははるかに低くなります。

  • HERE : データを最新の状態に保つため、1 週間以内はデータをキャッシュすることをお勧めします。ID シフトが 1% 未満になると、リリース時にリリースされると想定できます。これは、1 週間に約 1～2 回です。

  • Grab: 次の状況ではIDs の有効期限が切れたり無効になったりする可能性があります。

    • データオペレーション: POI は、現実世界のクローズ、重複した POI として検出された、または誤った情報を持つなど、グラウンドトゥルースに基づいて Grab Map Ops によって Grab POI データベースから削除される可能性があります。Grab は毎週データを Waypoint 環境に同期します。

    • 補間 POI : 補間 POI は、リクエストを処理するときにリアルタイムで生成される一時的な POI であり、レスポンスの place.result_typeフィールドで派生としてマークされます。補間された POIs の情報は少なくとも 30 日間保持されます。つまり、30 日以内に、プレイスの詳細 API からプレイス ID で POI の詳細を取得できます。30 日後、補間された POIs (場所 ID と詳細の両方) の有効期限が切れ、場所の詳細 API からアクセスできなくなる場合があります。