搜尋相符的房源

你可以使用商家檔案 API 建立平台,讓商家在 Google 上管理自己的商家。您可以在平台上,允許合作夥伴搜尋符合其商家名稱、地址和電話資料的商家資訊。他們可以建立地點擁有權,並根據經緯度準確定位商家的實際位置。

事前準備

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

如何使用地址資料

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

常用商家檔案資源

商家可透過 GoogleLocations API,預先查看某個地點是否已在商家檔案中被認領。如果沒有,商家可以立即要求存取權。

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

常用 Google 地圖資源

合作夥伴工作流程通常會使用 Maps JavaScript Places Widgets 建立互動式地圖。此外,下列 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 座標,因此可以改用 Maps JavaScript Places Widget 手動放置圖釘,建立準確的 LatLng 座標。

單一地址解析為三個相距 1,500 英尺的地點。為確保公司地址與 LatLng 座標正確連結,請手動調整每個地點的座標。

搜尋結果品質

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