有了 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 用途手動解析。
使用者修正搜尋
當合作夥伴平台的使用者搜尋地點時,如果遇到多個部分相符的結果,可以透過下列其中一種方式解決問題:
- 分析部分相符的地址,並選取正確的地址。
- 請編輯或重新輸入地址的部分,提高準確性,並將結果縮小為一個或零個相符項目。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=2&hl=zh-tw)
使用者從一或多個完整相符項目中選取
在某些情況下,多個地點可能會與使用者的搜尋地址完全相符。舉例來說,使用者可能會將下列位址輸入至合作夥伴平台:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
假設傳回以下回應,且所有回應都與指定的地址相符:
- 未經驗證的 Kasperson 印表機中心。
- Bengo Seguro (通過驗證的地點)。
- Garush Productions,未經驗證的地點。
使用者需要手動選取相符的商家。為確保消費者能取得準確的商家路線,可能需要調整這些地點的經緯度 (LatLng
) 資料,提高準確性。如要瞭解使用者如何手動輸入 LatLng
,請參閱手動調整地理位置資料。
手動調整地理位置資料
商家可以加入商家的經緯度 (LatLng
) 座標,提升商家檔案資訊的準確度。新商家可能無法知道 LatLng
座標,因此可以改用 Maps JavaScript 地點小工具手動放置圖釘,建立準確的 LatLng
座標。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=2&hl=zh-tw)
LatLng
座標建立關聯,您必須手動調整每個地點的座標。搜尋結果的品質
搜尋結果會因搜尋地址的準確度和地理區域而異。開發區域通常會減少顯示的地點數量,且不符合 Google 地址格式。這會導致搜尋結果品質降低,且越來越需要手動設定地址格式和使用 Maps API。