搜尋相符的商家資訊

有了 Business Profile API，您就能為商家建立在 Google 上管理業務的平台。在您的平台上，您可以允許合作夥伴搜尋符合商家名稱、地址和電話資料的商家資訊。他們可以建立地點擁有權，也能根據經緯度正確顯示商家的實際位置。

事前準備

使用 Business Profile API 前，請先註冊應用程式並取得 OAuth 2.0 憑證。如要進一步瞭解如何開始使用 Business Profile API，請參閱「基本設定」一文。

如何使用地址資料

如要使用自家平台上的地址和地理位置資料，你可以使用兩組不同的 API 和資源：Business Profile API 和 Maps API。

商家檔案的常用資源

GoogleLocations API 可讓商家事先查看是否有人已在商家檔案中聲明地點擁有權。否則，商家就能立即要求存取權。

PostalAddress 物件代表商家的實際地址。

常用的 Google 地圖資源

合作夥伴工作流程中經常使用 Maps JavaScript 地點介面集小工具來建立互動式地圖。此外，下列 Maps API 也很實用：

• 透過 Place Autocomplete 和 Place Details 傳回地點預測結果。如需定價詳情，請參閱「SKU：Autocomplete (included with Places Details) – Per Session」。
• 透過 Place Search 查詢地點資訊。如需定價詳細資料，請參閱 SKU：Find Place。
• 使用地理編碼提供地址地理編碼和反向地理編碼。如需定價詳細資料，請參閱 SKU：Geocoding。

一或多個相符結果

合作夥伴搜尋與某個地點相符的房源資訊時，目標是將搜尋結果縮小到一個或零個相符項目。這表示地點符合搜尋條件，或尚未存在於商家檔案中。

如果找到一或零個相符項目，請使用 accounts.locations.create 方法建立新商店資訊，或按照 GoogleLocations 指南聲明現有商家資訊的擁有權。如果 Google 無法進行地址的地理編碼，系統就無法建立位置，且 API 回應會包含 LatLng 資料的要求。如要瞭解商家如何提供 LatLng 資料，請參閱手動調整地理位置資料。

系統判定 LatLng 座標後，就會建立新的商店資訊。

部分與多個相符結果

當業主或合作夥伴營運團隊搜尋與地點相符的商家資訊時，他們輸入的資訊可能只會得到部分相符，或者可能收到多個與搜尋查詢相符的結果。如要將搜尋結果縮小為一或零個相符項目，系統會以手動方式解決部分和多個相符的結果，做法是以兩種 Maps API 用途手動解析。

使用者修正搜尋

當合作夥伴平台的使用者搜尋地點時，如果遇到多個部分相符的結果，可以透過下列其中一種方式解決問題：

• 分析部分相符的地址，並選取正確的地址。
• 請編輯或重新輸入地址的部分，提高準確性，並將結果縮小為一個或零個相符項目。

使用者從一或多個完整相符項目中選取

在某些情況下，多個地點可能會與使用者的搜尋地址完全相符。舉例來說，使用者可能會將下列位址輸入至合作夥伴平台：

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

假設傳回以下回應，且所有回應都與指定的地址相符：

• 未經驗證的 Kasperson 印表機中心。
• Bengo Seguro (通過驗證的地點)。
• Garush Productions，未經驗證的地點。

使用者需要手動選取相符的商家。為確保消費者能取得準確的商家路線，可能需要調整這些地點的經緯度 (LatLng) 資料，提高準確性。如要瞭解使用者如何手動輸入 LatLng，請參閱手動調整地理位置資料。

手動調整地理位置資料

商家可以加入商家的經緯度 (LatLng) 座標，提升商家檔案資訊的準確度。新商家可能無法知道 LatLng 座標，因此可以改用 Maps JavaScript 地點小工具手動放置圖釘，建立準確的 LatLng 座標。

搜尋結果的品質

搜尋結果會因搜尋地址的準確度和地理區域而異。開發區域通常會減少顯示的地點數量，且不符合 Google 地址格式。這會導致搜尋結果品質降低，且越來越需要手動設定地址格式和使用 Maps API。