使用 Amazon Location 反向地理編碼 - Amazon Location Service
開始反向地理編碼回應範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon Location 反向地理編碼

反向地理編碼是將一組座標轉換為有意義的文字的程序，例如地址、區域、商業名稱或興趣點。您可以使用放置索引資源提交反向地理編碼請求，並結合從反向地理編碼擷取的資料，以在 Web 或行動應用程式的地圖上顯示資料。

本節會引導您了解如何傳送簡單的反向地理編碼請求。

反向地理編碼

您可以提交簡單的請求來反轉一組座標的地理編碼，並將其轉換為有意義的地址、興趣點或沒有使用 SearchPlaceIndexForPosition操作的地址的一般位置。簡單請求包含下列必要參數：

  • Position – 您要轉換為地址、興趣點或一般位置的一組座標。使用 格式 定義[longitude,latitude]。

若要指定每頁結果的最大數量，請新增下列選用參數：

  • MaxResults – 限制查詢回應中傳回的結果數目上限。

如果您想要為查詢結果指定偏好的語言，請使用下列選用參數：

  • Language – 用於轉譯結果的語言代碼。值必須是有效的 BCP 47 語言代碼。例如，en針對英文。

注意

如果Language未指定 ，或結果不支援指定的語言，則會使用該結果的合作夥伴預設語言。

您可以使用 AWS CLI 或 Amazon Location APIs。

API

下列範例是搜尋位置索引資源的SearchPlaceIndexForPosition請求，ExamplePlaceIndex，對於有意義的地址、興趣點或位置附近的一般位置 【122.3394,47.6159].

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 5,
   "Language": "de"
}
AWS CLI

下列範例是搜尋位置索引資源的search-place-index-for-position命令，ExamplePlaceIndex，對於有意義的地址、興趣點或位置附近的一般位置 【122.3394,47.6159].

aws location \
    search-place-index-for-position \
        --index-name ExamplePlaceIndex \
        --position -122.3394 47.6159 \
        --max-results 5 \
        --language de

回應範例

以下是從 Amazon Location Places 呼叫 SearchPlaceIndexForPosition操作時的範例回應APIs。結果會傳回相關位置和請求摘要 。根據選取 Esri 或 Here 作為合作夥伴，會顯示兩個回應。

Example request
POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 1
}
Example response (Esri)
{
    "Results": [
        {
            "Place": {
                "AddressNumber": "2111",
                "Country": "USA",
                "Geometry": {
                    "Point": [
                        -122.33937999999995,
                        47.61591000000004
                    ]
                },
                "Interpolated": false,
                "Label": "The Spheres, 2111 7th Ave, Seattle, WA, 98121, USA",
                "Municipality": "Seattle",
                "Neighborhood": "Belltown",
                "PostalCode": "98121",
                "Region": "Washington",
                "SubRegion": "King County"
            },
            "Distance": 1.8685861313438727
        }
    ],
    "Summary": {
        "DataSource": "Esri",
        "MaxResults": 1,
        "Position": [
            -122.3394,
            47.6159
        ]
    }
}
Example response (HERE)
{
    "Summary": {
        "Position": [
            -122.3394,
            47.6159
        ],
        "MaxResults": 1,
        "DataSource": "Here"
    },
    "Results": [
        {
            "Place": {
                "Label": "2111 7th Ave, Seattle, WA 98121-5114, United States",
                "Geometry": {
                    "Point": [
                        -122.33938,
                        47.61591
                    ]
                },
                "AddressNumber": "2111",
                "Street": "7th Ave",
                "Neighborhood": "Belltown",
                "Municipality": "Seattle",
                "SubRegion": "King",
                "Region": "Washington",
                "Country": "USA",
                "PostalCode": "98121-5114",
                "Interpolated": false,
                "TimeZone": {
                    "Name": "America/Los_Angeles",
                    "Offset": -28800
                }
            },
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ",
            "Distance": 1.868586125090601
        }
    ]
}