Geocode - Amazon Location Service
使用案例了解請求了解回應

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

Geocode

地理編碼會將文字地址或位置名稱轉換為地理座標，以及詳細的地址元件和其他資訊。此 API 支援靈活的查詢，包括包含街道名稱、郵遞區號和區域的任意格式文字和結構化查詢。選用功能包括時區資料和政治觀點調整。

注意

儲存的結果會產生更高的儲存體定價。使用 IntendedUse 參數來指示單次使用或儲存。請參閱 Places 定價 以了解儲存結果的成本影響。

如需詳細資訊，請參閱《Amazon Location Service API 參考》中的 Geocode。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱如何使用 Geocode。

使用案例

  • 將補充資料新增至客戶地址：透過包含郵遞區號、座標和利用持久性儲存來支援明智的業務和行銷決策，以改善地址記錄。

  • 地址資料標準化：在資料管道或批次程序中套用地理編碼，以標準化地址資料，利用持久性儲存進行持續參考。

  • 確定時區：確定城市或地址的時區，為旅行、排程和發票等應用程式提供準確的時間戳記。

了解請求

請求接受選用參數，例如 AdditionalFeatures、 BiasPosition和 Filter，以精簡搜尋結果。其他選項，例如 MaxResults、 Language和 PoliticalView，可進一步自訂回應。必要參數為 Query，可以自由格式文字形式提供或結構化為 QueryComponents。如需詳細資訊，請參閱 Geocode API 參考。

請求包含下列關鍵參數：

身分驗證

對於身分驗證，如果使用其他方法，則 Key 參數為選用。

  • Key：用於身分驗證的選用參數。

如需詳細資訊，請參閱使用 Amazon Location Service 驗證

查詢和偏差

用於查詢結果和地理偏差的參數。

  • QueryText：搜尋位置的自由格式文字查詢。

  • QueryComponents：用於精確搜尋的地址號碼、國家/地區、地區或郵遞區號等結構化元件。

  • BiasPosition：偏差搜尋結果的地理位置。

如需詳細資訊，請參閱查詢和偏差

精簡結果

套用篩選條件以精簡結果。

  • Filter：篩選以包含特定國家/地區或地點類型。如需詳細資訊，請參閱篩選。

國際化和當地語系化

指定語言並套用當地語系化結果的政治檢視。

  • Language：結果的語言。

  • PoliticalView：套用反映領土宣告的政治觀點。

如需詳細資訊，請參閱當地語系化和國際化

其他功能

請求時區詳細資訊等其他資訊。

  • AdditionalFeatures：請求其他詳細資訊的選項，例如時區。如需詳細資訊，請參閱額外功能。

了解回應

回應提供 ResultItems，其中包含詳細的位置資料，例如 Address、Position、 PlaceId和其他相關屬性。也可能包含TimeZone資訊或MatchScores每個查詢元件的其他功能。每個 ResultItem 代表根據指定請求參數的相符位置或地理編碼結果。如需詳細資訊，請參閱 Geocode API 參考。

回應包含下列關鍵參數：

地址和相關詳細資訊

傳回位置的詳細資訊，包括地址元件。

  • Address：完整地址，包括國家、區域、郵遞區號和街道詳細資訊。

  • PostalCodeDetails：與郵遞區號相關的其他資訊。

  • StreetComponents：街道詳細資訊，包括基本名稱和類型。

位置類型和類別

傳回位置類型和類別的相關資訊。

  • Categories：描述位置的類別清單，例如餐廳、學校。

  • PlaceType：指定位置類型，例如城市、地址或區域。

結果分析

指出結果符合輸入查詢的分數。

  • MatchScores：相符精確度的分數。

    • Overall：以從 0.0 到 1.0 (0% 到 100%) 的規模，測量地址搜尋與您的輸入相符的程度。完美分數 1.0 表示在資料庫中找到了搜尋的每個部分。在包含聯絡人名稱或交付指示等額外詳細資訊時，看到較低的分數是正常的。這些自然會降低分數，但不一定表示地址錯誤。

    • Component Score：每個地址元件 （例如 AddressNumber或 PostalCode) 的評分比例為 0.0 到 1.0 (0% 到 100%)。這些分數指出地址的每個部分符合結果的準確度。例如，如果 AddressNumber、 Street和 PostalCode分數接近 1.0，即使整體分數因其他查詢詳細資訊而較低，您也可以信任配對。

    注意

    當特定元件 （例如 Street) 沒有出現分數時，該元件會計算為 0。這有助於識別可能需要驗證的部分地址。

    在處理通常包含額外資訊的實際地址搜尋時，此評分系統有助於在完全相符和實際可用性之間取得平衡。

其他詳細資訊

視需要包含額外的位置相關資訊。

  • AccessPoints：代表存取點的地理座標。

  • TimeZone：位置的時區資訊。