關於 Places API (新推出)

Places API (新版) 包含下列 API:

本文件概要說明這些新 API。

Place Details (新)

地點 ID 可專門用來識別 Google 地方資訊資料庫中的某個地點 Google 地圖。使用地點 ID 即可要求特定的詳細資料 啟動 Place Details (新功能),以建立建築物或搜尋點 請求。Place Details (新) 要求會傳回 例如完整地址、電話號碼、使用者評分 評論。

取得地點 ID 的方法有很多種,例如:

Place Photo (新)

Place Photo (New) API 可讓您新增高畫質相片內容 授予您應用程式存取權,方法是存取儲存在 Google 地點介面集資料庫。使用 Place Photo (New) API,您就可以存取 相片,並將圖片調整成最適合您應用程式的尺寸。

向 Place Photo (New) API 發出的所有要求都必須包含相片資源名稱。 專門用於識別要傳回的相片。即可取得相片資源 名稱使用:

如要在 Place Details (新版) 的回應中加入相片資源名稱,請按照下列步驟操作: Text Search (新版) 或 Nearby Search (新版) 要求,請務必將 要求欄位遮罩中的 photos 欄位。

Places API 提供兩種搜尋 API:

  • Text Search (新版)

    可指定用於搜尋地點的文字字串。例如: 「澳洲雪梨的素食素食餐點」或「附近的高級海鮮餐廳」 Palo Alto, CA"。

    如想修正搜尋範圍,請指定價位、 目前的營業狀態、評分或特定地點類型。你也可以 以便將結果自訂調整至特定位置,或限制搜尋 移到特定地點

  • Nearby Search (新版)

    可讓你指定要搜尋的區域類型以及地點類型清單。 將區域指定為以經緯度定義的圓形 中心點的座標和半徑 (單位為公尺)。

    指定一或多個地點類型,以便定義 。例如,指定「pizza_restaurant」和「shopping_mall」到 在指定條件內,搜尋位於購物中心內的披薩餐廳 區域。

這兩種搜尋主要的差別在於 Text Search (新版) 指定任意搜尋字串,而 Nearby Search (新版) 需要 搜尋區域

自動完成 (新功能) 和工作階段符記

Autocomplete (新版) 是一項網路服務,可傳回地點預測結果和 查詢預測結果來回應 HTTP 要求在要求中指定 搜尋字串和控制搜尋區域的地理邊界。

工作階段符記是使用者產生的字串,可將 Autocomplete (新) 呼叫追蹤為 工作階段。自動完成 (新版) 會使用工作階段符記,將查詢分組 使用者自動完成搜尋的選取階段,則會進入獨立的工作階段 帳單用途

新的欄位、屬性和無障礙選項

Places API (新版) 包含新的欄位、屬性和無障礙選項 為使用者提供地點的詳細資訊。這些層面 。

欄位

Places API (新版) 包含多個新欄位:

欄位 說明
regularSecondaryOpeningHours 說明特定運算的特定時間。次要 營業時間與商家的主要營業時間不同。適用對象 例如餐廳可以指定「免下車服務」或「外送」 以小時做為次要營業時間
paymentOptions 商家接受的付款方式。一個地點可接受超過 多種付款方式如果沒有可用的付款方式資料, 系統會取消設定付款方式欄位。以下是可用選項:
  • 信用卡
  • 簽帳金融卡
  • 只收現金
  • NFC 付款
parkingOptions 地點提供的停車位。以下是可用選項:
  • 免費停車場
  • 收費停車場
  • 免費路邊停車
  • 代客停車服務
  • 免費室內停車場
  • 付費室內停車場
subDestinations 與特定地點相關的獨特地點。適用對象 舉例來說,機場航廈是 例如機場、終止機場等。
fuelOptions 有關燃油選項的最新資訊, 加油站。這項資訊會定期更新。選項包括 :
  • 柴油
  • 一般未上門
  • 中級汽油
  • 進階級
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • 液化石油氣
  • E80
  • E85
  • 甲烷
  • 生質柴油
  • 卡車柴油
evChargeOptions 這個充電站的電動車 (EV) 充電器數量。雖然 有些電動車充電器有多個連接器,每個充電器只能 一次只收取一輛車的費用因此,這個欄位反映出 在特定時間內可用的電動車充電器數量。
shortFormattedAddress 人類可讀的簡短地址,
primaryType 指定結果的主要類型。例如,某個地點 可歸類為 cafeairport。A 罩杯 地點只能有一個主要類型。如需 可能的值,請參閱「支援的類型」。
primaryTypeDisplayName 主要類型的顯示名稱,已根據要求本地化 語言。如需可能值的完整清單 請參閱「支援的類型」。

屬性

Places API (新版) 包含下列幾個新屬性:

屬性 說明
outdoorSeating 地點提供室外雅座。
liveMusic 這裡提供現場音樂演出。
menuForChildren 地點有兒童菜單。
servesCocktails 地點供應雞尾酒。
servesDessert 提供甜點的地點。
servesCoffee 地點供應咖啡。
goodForChildren 這個地點適合兒童。
allowsDogs 允許帶狗進入。
restroom 地點設有洗手間。
goodForGroups 地點可容納所有群組。
goodForWatchingSports 地點適合觀賞運動賽事。

無障礙功能選項

Places API (新版) 包含下列無障礙選項欄位:

欄位 說明
wheelchairAccessibleParking 地點提供無障礙停車位。
wheelchairAccessibleEntrance 地點設有無障礙入口。
wheelchairAccessibleRestroom 地點設有無障礙洗手間。
wheelchairAccessibleSeating 地點提供無障礙座位。

遷移至 New Places API

如果您是 Places API 的現有客戶,而且想將應用程式遷移至 新版 API,請參閱下列遷移說明文件: