搜尋相符的商家資訊

有了 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 也很實用:

一或多個相符結果

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

如果找到一或零個相符項目,請使用 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 座標。

一個地址會解析為相距 1,500 英尺的三個位置。為了正確將商家地址與 LatLng 座標建立關聯,您必須手動調整每個地點的座標。

搜尋結果的品質

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