

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

# 放置 APIs

位置可讓應用程式搜尋、尋找和擷取有關興趣點、地址和特定位置的詳細資訊。這些功能透過提供內容和改善搜尋函數的使用者體驗來增強以位置為基礎的服務。
+ **Geocode**：將地址或位置名稱轉換為地理座標 （經度、緯度），支援需要address-to-location轉換以進行映射和空間分析的應用程式。如需詳細資訊，請參閱[反向地理碼](reverse-geocode.md)。
+ **反向地理碼**：將地理座標轉換為最近的地址或位置名稱，提供位置的內容。如需詳細資訊，請參閱 [反向地理碼](reverse-geocode.md)。
+ **自動完成**：建議使用者輸入文字的潛在完成，提高搜尋輸入的效率。如需詳細資訊，請參閱 [自動完成](autocomplete.md)。
+ **GetPlace**：擷取指定位置的詳細資訊，包括地址、聯絡詳細資訊和營業時間等屬性。如需詳細資訊，請參閱 [GetPlace](get-place.md)。
+ **SearchNearby**：尋找指定地理點指定半徑內的位置，適用於「我附近」搜尋。如需詳細資訊，請參閱 [搜尋附近](search-nearby.md)。
+ **SearchText**：允許根據關鍵字或片語以文字為基礎的搜尋感興趣的位置或點，非常適合依名稱或描述尋找位置。如需詳細資訊，請參閱 [搜尋文字](search-text.md)。
+ **建議**：以使用者類型提供搜尋字詞建議，增強搜尋相關性和使用者體驗。如需詳細資訊，請參閱 [建議](suggest.md)。

下表顯示一些使用 Places APIs 最佳解決的業務使用案例。

## 放置使用案例
<a name="places-table"></a>

下一節介紹了許多使用 Places APIs 最佳解決的業務使用案例。


| **業務需求** | **有用的 API** | **範例** | 
| --- | --- | --- | 
| **在應用程式中新增鄰里商業資訊**<br />也會傳回商業資訊，例如類別和食品類型。 | `SearchNearBy` |  | 
| **業務鏈的鄰近性搜尋**<br />也會傳回商業資訊，例如類別、食品類型和存取點。 | 搜尋文字建議  |  | 
| **依電話名稱搜尋 **<br />也會傳回商業資訊，例如類別、食品類型和存取點。 | 搜尋文字建議  |  | 
| **依位置名稱、POI、類別搜尋**<br />也會傳回商業資訊，例如類別、食品類型和存取點。 | 搜尋文字建議 | [如何使用名稱搜尋地點、POI 或企業](how-to-search-for-place-poi-business.md) | 
| **將建議預測為使用者金鑰查詢**<br />也會傳回商業資訊，例如類別、食品類型和存取點。 | 建議 | [如何根據輸入預測建議](how-to-predict-suggestions.md) | 
| **在結帳頁面上自動完成或建議自動填寫地址**標準化和標準化地址。 | 自動完成，建議  | [如何完成地址](how-to-complete-address.md) | 
| **將特定地址轉換為經度和緯度座標**<br />標準化和標準化地址。 | Geocode |  | 
| **將經度和緯度座標轉換為對應的地址 **<br />標準化和標準化地址。 | 反向地理碼 | [如何反轉位置的地理碼](how-to-reverse-geocode-position.md) | 
| **取得城市的時區 **<br />支援 UTC 位移和時區名稱。 | Geocode |  | 
| **取得經度和緯度的時區 **<br />支援 UTC 位移和時區名稱。 | 反向地理碼  |  | 
| **依位置 ID 取得位置 **<br />傳回商業資訊，例如類別、聯絡人、營業時間和存取點。 | 取得位置 | [如何取得 PlaceId 的結果](how-to-get-place-by-id.md) | 
| **取得興趣點的名稱、聯絡人和營業時間 **<br />傳回商業資訊，例如類別、食品類型和存取點。 | 搜尋文字、搜尋附近、建議 |  | 
| 提供位置名稱的位置類型 支援預先篩選。 | Geocode Autocomplete |  | 
| 提供緯度/經度座標的位置類型 支援預先篩選。 | 反向地理碼 |  | 
| **為地址或 POI 提供 poi 類別 （例如醫院、商店、美術館等）**<br />支援預先篩選。 | 搜尋文字、搜尋附近、建議 |  | 
| **新增用於完成或預測的預先類型搜尋行為**<br />支援經濟實惠、僅限標籤和地址元件。 | 自動完成建議 | [如何根據輸入預測建議](how-to-predict-suggestions.md) | 
| **在地圖上視覺化位置搜尋和/或地理碼結果 **所有 APIs 都會傳回地理座標，但自動完成除外。 | GetTile 和 GetStyleDescriptor 搭配 Places API 的轉譯引擎 (MapLibre) |  | 
| **增強、清理、標準化和標準化您的地址資料庫**支援地址標籤、元件、時區等。 | Geocode，反向 Geocode  |  | 