搜尋相符的房源

您可以利用 Business Profile API 建立平台,讓商家在 Google 上管理自家商家。在平台上,您可以允許合作夥伴搜尋符合其商家名稱、地址和電話號碼資料的房源。他們可以建立地點的擁有權,並根據經緯度準確標示商家的實際位置。

事前準備

使用商家檔案 API 前,您必須註冊應用程式並取得 OAuth 2.0 憑證。如要進一步瞭解如何開始使用 Business Profile API,請參閱「基本設定」。

如何使用地址資料

如要在平台上使用地址和地理位置資料,您可以使用兩組不同的 API 和資源:商家檔案 API 和地圖 API。

常用的商家檔案資源

GoogleLocations API 可讓商家事先查看某個地點是否已在商家檔案中聲明為自家地點。如果沒有,則允許商家立即要求存取權。

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

常用的 Google 地圖資源

合作夥伴工作流程通常會使用 Maps JavaScript 地點小工具來建立互動式地圖。此外,下列 Maps API 也相當實用:

一個或零個相符項目

當合作夥伴搜尋某個地區的符合產品資訊時,他們的目標是將搜尋結果縮減為一個或零個相符項目。這表示該地點分別符合或不符合搜尋條件。

如果只有一個或沒有相符項目,請使用 accounts.locations.create 方法建立新的商店資訊,或是按照 GoogleLocations 指南聲明現有商店資訊的擁有權。如果 Google 無法為地址建立地理編碼,位置建立作業就會失敗,API 回應則會包含 LatLng 資料的要求。如要瞭解商家如何提供 LatLng 資料,請參閱「手動調整地理位置資料」。

確定 LatLng 座標後,系統就會建立新商店資訊。

部分相符和多重相符

當商家擁有者或合作夥伴的作業團隊搜尋與某個地點相符的房源時,他們輸入的資訊可能只會部分比對成功,或是他們可能會收到多個與搜尋查詢相符的房源。為了將搜尋結果縮小到只包含一個或零個相符項目,我們使用兩個 Maps API 用途手動解決部分和多個相符項目。

合作夥伴平台使用者搜尋地點時,如果出現多個部分相符結果,可以透過下列任一方式解決問題:

  • 分析部分相符的地址,然後選取正確的地址。
  • 編輯或重新輸入部分地址,以提高準確度,並將結果縮小至零或一個相符項目。
使用者在搜尋地址時,會看到幾個部分相符的結果。

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

在某些情況下,多個地點可能都與使用者的搜尋地址完全相符。舉例來說,使用者可能會在合作夥伴平台中輸入以下地址:

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 座標。

單一地址會解析為三個相距 1,500 英尺的區域。如要準確將商家地址與其LatLng座標建立關聯,請手動調整每個地點的座標。

搜尋結果品質

搜尋結果會因搜尋的地址準確度和地理區域而有極大差異。開發中國家/地區通常會顯示較少的 Google 地圖地點,且不一定符合 Google 地址格式。這會導致搜尋結果品質降低,並增加手動設定地址格式和使用 Maps API 的需求。