地區設定

如要設定地點，您必須完成下列階段：

探索地區

已發布的已驗證地點會成為 Google 搜尋和 Google 地圖搜尋結果的標準功能。這些地點已有經過驗證的現有擁有者。如要將擁有權從某個 Google 帳戶變更為另一個帳戶，您必須提出擁有權要求。由在地嚮導或使用者社群建立但尚未聲明擁有權的地點，則會視為未驗證。平台會建立及驗證新地點。

如要使用 Business Profile API 設定地點，您需要為商家建立平台，以便在 Google 上管理商家。在平台中，您可以讓使用者搜尋符合商家名稱、地址和電話資料的商家資訊。

GoogleLocations API 可讓您事先查看某個地點是否已在其他商家檔案中有人聲明擁有權。如果尚未聲明地點的擁有權，您可以立即要求該地點的擁有權。否則，您必須建立並驗證新的地點。

詳情請參閱搜尋相符的商家資訊指南。

地點搜尋結果

當您搜尋地點商家資訊時，請按照下列步驟聲明新地點的擁有權：

  1. 收集商家的位置資料，例如商家名稱、地址和類別。
  2. 呼叫 googleLocations.search 端點，並在呼叫的要求主體中提供位置資料。或者，您也可以搜尋查詢字串，類似於使用者在 Google 搜尋或 Google 地圖中輸入的內容。舉例來說，「Starbucks 5th ave NYC」是查詢字串。

  3. API 會傳回可能相符的地點清單，以及每個地點的相關資訊，例如每個地點的 locationName 和地址。

    當您收到 API 傳回的清單時，有兩種選項：

    1. 如果沒有任何相符項目，請建立新地點並繼續驗證。

    2. 如有一或多個相符項目，請要求業主選取最接近的項目。

      如果「requestAdminRightsUrl」存在，建議的擁有者必須登入自己的 Google 帳戶，並按一下連結來啟動擁有權要求程序。

      如果沒有 requestAdminRightsUrl，請建立新位置並繼續驗證。

擁有權要求

商家信任、明確通訊和 Google 帳戶是擁有權聲明程序的核心。擁有權聲明可能會有部分自動化作業，某些步驟會要求預定的業主離開平台、登入 Google 帳戶，以及點選商家檔案中的按鈕或連結。

商家轉移作業最多可能需要 7 天才能成功完成。當最後轉移要求時，商家必須登入帳戶，並手動完成擁有權聲明程序。

現有業主可能會拒絕要求，提案擁有者可能無法對 Google 的通知電子郵件採取行動。如果擁有權聲明遭拒，提案的業主可以手動提出申訴。

為了盡可能減少流失的情況，我們建議你制定一套程序來追蹤擁有權要求。建議您在提出版權聲明後 7 至 10 天內，自動或手動與提出擁有者聯絡。

營業地點擁有權程序總覽

下圖說明位置擁有權程序：

Swimlane 的位置擁有權程序圖。
圖 1.位置擁有權程序總覽圖表

重複項目

如果你加入的營業地點已經通過商家檔案驗證，就不會顯示在 Google 地圖上，且會在帳戶中標示為「重複地點」。您只能有一個經過驗證的地點。重複的地點未經驗證且未發布。您不需要手動移除重複內容。

評論通常會遷移至新通過驗證的地點。詳情請參閱「在商家資訊之間移動評論」一文。

建立地點

在 Google 地圖中，地點會以地點 ID 表示，商家檔案帳戶和地點則以帳戶 ID 和地區 ID 表示。

位置和地點

你建立新的地點後，系統就會將其與 Google 地圖中的地點建立關聯。這也適用於區域服務商家，即使地址並未公開顯示。

建立地點時，建議您採取下列做法：

  • 如果您是需要規劃程序的業主，Google Maps JavaScript 的 Places 小工具和 Geocoding API 提供最完善、最具經驗的方式，可讓您在地圖上放置圖釘，準確找出商家位置。
  • 新開發和高成長區域可能需要經緯度座標。Google 地圖通常會建立地點 ID、地址和經緯度資料。

地點和地點之間有多對多關係。同一個地點 ID 可以有多個相關聯的地點。舉例來說，購物中心或醫院內的部門就是多個地點。 反之，單一地點也可以有多個相關聯的地點 ID。詳情請參閱「在 Google 上宣傳商家的相關規範」一文。這些指南適用於所有使用者。

地圖地點 ID

地圖地點 ID 重複，可能會隨時間改變。如要瞭解如何安全快取、儲存及管理地圖地點 ID、多個地點 ID，以及如何設定範圍，請參閱地點 ID 指南。

如要瞭解如何建立及更新平面圖，請參閱使用室內地圖查看平面圖指南。

OAuth 憑證

請盡可能使用業主的 OAuth 憑證來建立地點。這麼做會將擁有者的 Google 帳戶建立為主要擁有者，以便管理邀請及變更擁有權，但不會使用擁有者的名稱。

API 物件和列出狀態

API Location 物件會封裝與位置相關聯的所有資訊。 Metadata 物件可提供地點的詳細資料，例如 Google 地圖網址。

如需各項商家資訊狀態的詳細說明，請參閱「瞭解您的商家資訊狀態」一文。

類別和屬性

建立或更新地點時，建議您透過最新的類別和屬性清單進行查詢。可用類別和屬性清單隨時可能有所變動。

使用 categories.list 和 attributes.list API 方法，從 Google 取得日期清單的準確更新。可用選項本地化，而且會因語言和地區而異。這個 API 使用 BCP 47 語言代碼和 ISO 3166-1 alpha-2 國家/地區代碼來描述語言和區域。

聯絡地址

地址必須符合商家檔案的區域與郵寄地址規定。比起在 Google 地圖找到的未驗證社群來源商家，這些規定通常更高。在地嚮導和 Google 搜尋的使用者可以為尚未聲明擁有權的地點輸入商家地址和詳細資料。這些資訊通常為口說，且採用非標準格式。

此開放原始碼專案可能有助於您的平台符合這些需求。

商家、營運團隊和第三方可協助確保準確度。

使用 validateOnly=true 參數組合呼叫 accounts.locations.create 時，建議您確認所有必填欄位是否存在，且郵寄地址的格式正確無誤。

Geocoding

地理編碼會將地址轉換成地理座標，方便您在地圖上放置標記或設定地圖位置。

經緯度座標用於在 Google 地圖中透過地理編碼、地點 API 建立實際地點，也可搭配第三方資料使用。

商家、營運團隊和第三方可協助確保地址正確連結至代表經緯度座標組合的地點。

最新位置

位置資訊的變更主要由營業地點擁有者和管理員造成，但也可能來自更廣泛的網路社群、在地嚮導和 Google。Google 如何收集及顯示商家資訊 說明瞭更新內容的管理方式，以及更新內容在 Google 地圖和搜尋結果中的顯示方式。

系統通常會接受編輯內容，但不保證一定會予以修改。如要進一步瞭解審查和發布程序，請參閱「編輯內容的後續情況」和「管理 Google 資訊更新」支援頁面。

locations.getGoogleUpdated 方法會傳回 Google 位置編輯內容的詳細資料。如要進一步瞭解如何接受或拒絕這些更新，請參閱「管理 Google 更新」指南。

驗證地點

地點驗證程序會將地點發布至 Google 地圖和 Google 搜尋。未驗證的商家不會公開顯示。這個程序會確認營業地點擁有者的身分，並有效將 Google 帳戶連結至該位置。可能需要擁有者輸入 PIN 碼來驗證地點。

平台式驗證

合作夥伴平台可以驗證地點，使用者不必離開平台就能驗證。平台會查詢可用的驗證方法 (例如電子郵件、簡訊、語音和明信片)，或是在必要時自動提示業主選擇偏好的方法。Google 服務會將 PIN 碼驗證碼傳送給業主。如果可以使用自動驗證，業主無須執行任何步驟即可成功驗證商家。

下圖顯示平台式驗證程序：

平台式驗證總覽流程的 Swimlane 圖。
圖 2. 平台式驗證總覽圖

最佳做法

在某些情況下，驗證程序最多可能需要數天才能完成。您需要輪詢驗證狀態。如果系統傳回空白的驗證方法清單，請使用「重試」。

如果商家名稱、地址和類別有異動，就會觸發重新驗證。請先執行這些類型的編輯作業，再開始驗證程序。

如要提高商家轉換率，請按照下列最佳做法操作：

  • 評估各種驗證方法的顯示頻率。
  • 評估各對話方塊和步驟的流失率。
  • 如果營業地點尚未通過驗證，請與商家進行後續追蹤。

連鎖店和品牌

連鎖店和品牌的營運要求各有不同，因此可以達成加盟、加盟店和合作夥伴的目標。鏈結是由專屬合作夥伴與支援團隊負責管理。

如要進一步瞭解連鎖店的註冊、建立及驗證作業，請參閱「針對 10 個以上的營業地點提出大量驗證申請」指南。

通過驗證後，即可透過 Business Profile API 管理已發布的連鎖店地點，做法與管理其他地點的方式相同，但有部分例外。舉例來說，營業地點管理員的處理方式不同，甚至能將他們加入加盟店。詳情請參閱「商家資訊擁有者和管理員」一文。

建立連結的方式

為了方便搜尋，您可以將地點資訊連結至 Google Ads、貼文和評論。

如要瞭解如何將商家檔案帳戶與 Google Ads 同步，請參閱「Google Ads 整合」指南，以及 Google Ads 開發人員網誌上的「使用 Business Profile API 來管理地點額外資訊」一文。

如需一般資訊及進一步瞭解 AdWords API，請參閱 AdWords API 開發人員網站或 Adwords API 論壇。

Business Profile API 的地點 storeCode 必須與 Google Ads 店面商品目錄動態饋給值相符。

使用下列格式建構深層連結：

https://business.google.com/{edit|posts|reviews}/l/u{location_id}

Business Profile API 會傳回未經模糊處理的帳戶和地區 ID。商家檔案的網頁介面會使用經過模糊處理和未模糊處理的 ID。

須遵守使用者的登入和存取限制。舉例來說，Google 帳戶使用者必須具備地點擁有者或管理員的權限，才能編輯地點。

深入分析結果

這個 API 提供多項地區洞察資料和指標。

在每個位置，您可以使用下列metrics進行分析：

  • 使用者直接搜尋位置時，系統顯示資源的頻率。
  • 資源透過類別搜尋 (例如餐廳) 顯示的頻率。
  • 該資源在 Google 搜尋上的瀏覽次數。
  • 當地貼文在 Google 搜尋上獲得的觀看次數。
  • 該資源在 Google 地圖上瀏覽次數的次數。
  • 網站的點擊次數。
  • 電話號碼的點擊次數。
  • 行車路線要求的次數。
  • 行動號召按鈕的點擊次數。
  • 商家上傳的相片瀏覽次數。
  • 商家目前上傳的影片總數。

如要進一步瞭解位置深入分析結果，請參閱「擷取位置洞察資料」一文。