您可以利用 Business Profile API 建立平台,讓商家在 Google 上管理自家商家。在平台上,您可以允許合作夥伴搜尋符合其商家名稱、地址和電話號碼資料的房源。他們可以建立地點的擁有權,並根據經緯度準確標示商家的實際位置。
事前準備
使用商家檔案 API 前,您必須註冊應用程式並取得 OAuth 2.0 憑證。如要進一步瞭解如何開始使用 Business Profile API,請參閱「基本設定」。
如何使用地址資料
如要在平台上使用地址和地理位置資料,您可以使用兩組不同的 API 和資源:商家檔案 API 和地圖 API。
常用的商家檔案資源
GoogleLocations
API 可讓商家事先查看某個地點是否已在商家檔案中聲明為自家地點。如果沒有,則允許商家立即要求存取權。
PostalAddress
物件代表商家的實際地址。
常用的 Google 地圖資源
合作夥伴工作流程通常會使用 Maps JavaScript 地點小工具來建立互動式地圖。此外,下列 Maps API 也相當實用:
- 使用 Place Autocomplete 和 Place Details 傳回地點預測結果。如需價格詳情,請參閱「SKU:Autocomplete (包含 Places Details) – 按工作階段計費」。
- 使用 Place Search 查詢地點資訊。如需定價詳細資料,請參閱「SKU:Find Place」。
- 使用地理編碼功能,為地址提供地理編碼和反向地理編碼。如需定價詳細資訊,請參閱「SKU:地理編碼」。
一個或零個相符項目
當合作夥伴搜尋某個地區的符合產品資訊時,他們的目標是將搜尋結果縮減為一個或零個相符項目。這表示該地點分別符合或不符合搜尋條件。
如果只有一個或沒有相符項目,請使用 accounts.locations.create
方法建立新的商店資訊,或是按照 GoogleLocations
指南聲明現有商店資訊的擁有權。如果 Google 無法為地址建立地理編碼,位置建立作業就會失敗,API 回應則會包含 LatLng
資料的要求。如要瞭解商家如何提供 LatLng
資料,請參閱「手動調整地理位置資料」。
確定 LatLng
座標後,系統就會建立新商店資訊。
部分相符和多重相符
當商家擁有者或合作夥伴的作業團隊搜尋與某個地點相符的房源時,他們輸入的資訊可能只會部分比對成功,或是他們可能會收到多個與搜尋查詢相符的房源。為了將搜尋結果縮小到只包含一個或零個相符項目,我們使用兩個 Maps API 用途手動解決部分和多個相符項目。
使用者調整搜尋範圍
合作夥伴平台使用者搜尋地點時,如果出現多個部分相符結果,可以透過下列任一方式解決問題:
- 分析部分相符的地址,然後選取正確的地址。
- 編輯或重新輸入部分地址,以提高準確度,並將結果縮小至零或一個相符項目。
![](https://developers.google.cn/static/my-business/images/partial-match.png?authuser=0&hl=zh-tw)
使用者從一或多個完全相符項目中選取
在某些情況下,多個地點可能都與使用者的搜尋地址完全相符。舉例來說,使用者可能會在合作夥伴平台中輸入以下地址:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
假設系統傳回下列回應,且所有回應都與所提供的地址相符:
- Kasperson Printer Center,未經驗證的位置。
- Bengo Seguro,已驗證的位置。
- Garush Productions,未經驗證的地點。
使用者必須手動選取相符的商家。為確保能為消費者提供前往商家的正確路線,這些地點的經緯度 (LatLng
) 資料可能需要調整,以提高準確度。如要瞭解使用者如何手動輸入 LatLng
,請參閱「手動調整地理位置資料」。
手動調整地理位置資料
商家可以新增商家的經緯度 (LatLng
) 座標,提高商家檔案資訊的準確度。新商家可能不知道自己的 LatLng
座標,因此可以改用 Google 地圖 JavaScript 地點小工具手動放置圖釘,以建立準確的 LatLng
座標。
![](https://developers.google.cn/static/my-business/images/latlng-manual-adjustment.png?authuser=0&hl=zh-tw)
LatLng
座標建立關聯,請手動調整每個地點的座標。搜尋結果品質
搜尋結果會因搜尋的地址準確度和地理區域而有極大差異。開發中國家/地區通常會顯示較少的 Google 地圖地點,且不一定符合 Google 地址格式。這會導致搜尋結果品質降低,並增加手動設定地址格式和使用 Maps API 的需求。