ユーザーが同様の結果を曖昧にしない方法 - Amazon Location Service
潜在的なユースケース例

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

ユーザーが同様の結果を曖昧にしない方法

提案 API を使用すると、結果の場所またはカテゴリのクエリを作成できます。結果は、一致する可能性が低くなるようにソートされます。結果ごとに情報が提供されるため、特にタイトルフィールドとラベルフィールドに関して、正しい一致をすばやく特定できます。

潜在的なユースケース

  • 結果オプションを表示する: ニーズに最適なオプションを選択できます。

例

タイトルフィールドは通常、結果が意図したものであるタイミングを理解するのに十分な情報です。タイトルに十分な情報がない場合、ラベルフィールドを使用してアドレス情報コンテキストを結果に追加します。ラベルフィールドは 2 行目の情報として提供でき、結果がレンダリングされたときにメインテキストから強調解除されます。以下の例では、2 つの同様の結果が提供されており、ホテルの住所がニーズにより適したものを選択するのに役立ちます。さらに、結果をマップでレンダリングできるように位置が指定されているため、結果を別の方法で選択することができます。

Sample request
{
  "QueryText": "Marriott",
  "Filter": {
    "IncludeCountries": [
      "USA"
    ],
    "BoundingBox": [
      -71.15693983012913,42.261623506672635,
      -70.97249727163558,42.37584075627763
    ]
  },
  "AdditionalFeatures": [
    "Core"
  ]
}
Sample response
{
    "ResultItems": [
        {
            "Title": "Marriott-Boston Cambridge",
            "SuggestResultItemType": "Place",
            "Place": {
                "PlaceId": "Redacted",
                "PlaceType": "PointOfInterest",
                "Address": {
                    "Label": "Marriott-Boston Cambridge, 50 Broadway, Cambridge, MA 02138-4137, United States",
                    "Country": {
                        "Code2": "US",
                        "Code3": "USA",
                        "Name": "United States"
                    },
                    "Region": {
                        "Code": "MA",
                        "Name": "Massachusetts"
                    },
                    "SubRegion": {
                        "Name": "Middlesex"
                    },
                    "Locality": "Cambridge",
                    "District": "MIT",
                    "PostalCode": "02138-4137",
                    "Street": "Broadway",
                    "StreetComponents": [
                        {
                            "BaseName": "Broadway",
                            "Language": "en"
                        }
                    ],
                    "AddressNumber": "50"
                },
                "Position": [
                    -71.0858,
                    42.36294
                ],
                "Distance": 5212,
            ...
        },
        {
            "Title": "Marriott-Boston Copley Place",
            "SuggestResultItemType": "Place",
            "Place": {
                "PlaceId": "Redacted",
                "PlaceType": "PointOfInterest",
                "Address": {
                    "Label": "Marriott-Boston Copley Place, 110 Huntington Ave, Boston, MA 02116-5706, United States",
                    "Country": {
                        "Code2": "US",
                        "Code3": "USA",
                        "Name": "United States"
                    },
                    "Region": {
                        "Code": "MA",
                        "Name": "Massachusetts"
                    },
                    "SubRegion": {
                        "Name": "Suffolk"
                    },
                    "Locality": "Boston",
                    "District": "Back Bay",
                    "PostalCode": "02116-5706",
                    "Street": "Huntington Ave",
                    "StreetComponents": [
                        {
                            "BaseName": "Huntington",
                            "Type": "Ave",
                            "TypePlacement": "AfterBaseName",
                            "TypeSeparator": " ",
                            "Language": "en"
                        }
                    ],
                    "AddressNumber": "110"
                },
                "Position": [
                    -71.0792,
                    42.34701
                ],
                "Distance": 3362,
            ...
        },
        ...
    ],
    "QueryRefinements": []
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/suggest?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "Marriott",
  "Filter": {
    "IncludeCountries": [
      "USA"
    ],
    "BoundingBox": [
      -71.15693983012913,42.261623506672635,
      -70.97249727163558,42.37584075627763
    ]
  },
  "AdditionalFeatures": [
    "Core"
  ]
}'
AWS CLI
aws geo-places suggest --key ${YourKey} \
--query-text "Marriott" \
--filter '{"IncludeCountries": ["USA"], "BoundingBox": [ -71.15693983012913,42.261623506672635, -70.97249727163558,42.37584075627763]}' \
--additional-features "Core"