產品最新動態

我們更新了多項 API,詳細說明如下。

地圖介面集

地圖介面集產品沒有任何異動。請參閱 API 相關計費異動說明。

路徑介面集

路徑介面集產品沒有任何異動。請參閱 API 相關計費異動說明。

地點介面集

Places Details

Places Details 要求可限制於特定欄位

Places Details 要求已更新為只會傳回您指定的欄位。Places Details 先前會傳回與指定地點有關的所有可用資料。這項異動生效之後,Places Details 要求只會傳回您透過 fields 參數指定的欄位。這些欄位對應至 Places Details 結果,共分為三個計費類別:「基本」、「聯絡資訊」和「氣氛」,每個要求的費用會根據所選欄位而有所不同。如未指定任何欄位,系統會傳回該指定地點的所有可用資料,並向您收取最高費用。

所有 Places Details 要求的價格均以基本費率為準。

基本類別不會產生任何額外費用,屬於這個類別的欄位如下:

address_componentadr_addressformatted_addressgeometryiconnamepermanently_closedphotoplace_idplus_codetypeurlutc_offsetvicinity

聯絡資訊類別會產生額外費用,屬於這個類別的欄位如下:

formatted_phone_numberinternational_phone_numberopening_hourswebsite

氣氛類別會產生額外費用,屬於這個類別的欄位如下:

price_levelratingreview

注意事項:無論使用者是否要求傳回歸因 (html_attributions),每次呼叫都會傳回這項元素。

建議做法:

  • 評估您的應用程式,看看目前使用的 Places Details 資料有哪些
  • 更新程式碼,加入 fields 參數
  • 登入 Google Cloud Platform Console,瞭解您目前的 Places API 使用情形。如需主控台的相關說明,請造訪 Google 帳戶說明中心

範例

您可以使用 fields 參數指定 Places Details 要求傳回的欄位,如下方範例所示 (指定的欄位為 nameratingformatted_phone_number):

網路服務

https://maps.googleapis.com/maps/api/place/details/json?placeid={PLACE_ID}&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY 

JavaScript

const placeId = 'not_actually_a_place_id';
const request = {
  placeId: placeId,
  fields: ['name', 'rating', 'formatted_phone_number']
};
const service = new google.maps.places.PlacesService(map);
service.getDetails(request, callback); 

Find Place

網路服務

我們已在網路服務中推出 Find Place,這項新服務會在使用者輸入文字或電話號碼後傳回地點。文字輸入內容可以是任何種類的地點資料,例如名稱、地址或電話號碼。您必須在 Find Place 服務中使用 fields 參數,才能收到所需的欄位。「基本」、「聯絡資訊」或「氣氛」類別欄位的計費方式與 Places Details 要求相同。如果您未指定任何欄位,系統會傳回地點搜尋結果的 PlaceId,但不會向您收取費用。

建議做法:

考慮遷移您現有的 Place Search 要求,改用 Find Place 服務。

JavaScript

我們針對 JavaScript 推出了兩個新的 Find Place API。Find Place From Query 服務會接收文字查詢,然後傳回地點。查詢內容可以是任何種類的地點資料,例如名稱或地址。Find Place From Phone Number 服務會接收電話號碼,然後傳回地點。您必須在這兩個 Find Place API 中使用 fields 參數,才能收到所需的欄位。「基本」、「聯絡資訊」或「氣氛」類別欄位的計費方式與 Places Details 要求相同。您必須設定 fields 參數,如未指定任何欄位,要求就會產生錯誤。

建議做法:

考慮遷移您現有的 Text Search 要求,改用 Find Place 服務。

範例

以下範例顯示搜尋「Museum of Contemporary Art Australia」(澳洲當代藝術博物館) 的 Places API 網路服務 Find Place 要求,指定的欄位包括 photosformatted_addressnameratingopening_hoursgeometry

網路服務

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY

JavaScript

var map;
var service;
var infowindow;

function initMap() {
  var circularquay = new google.maps.LatLng(-33.8617374,151.2021291);

  map = new google.maps.Map(document.getElementById('map'), {
    center: circularquay,
    zoom: 15
  });

  var request = {
    query: 'Museum of Contemporary Art Australia',
    fields: ["photos", "formatted_address", "name", "rating", "opening_hours", "geometry"],
  };

  service = new google.maps.places.PlacesService(map);
  service.findPlaceFromQuery(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      var place = results[i];
      createMarker(results[i]);
    }
  }
}

地點介面集的行動應用程式 SDK

Google 正在準備推出新版的 Places SDK for AndroidPlaces SDK for iOS。下節將說明異動內容及相關影響。

  • 新的 Places SDK for Android 將以獨立程式庫的形式提供,而不再透過 Google Play 服務提供。未來此版本與現行 SDK 將無法回溯相容。
  • 我們將會推出新的 Places SDK for iOS。

值得注意的是,我們將更新數個 Places SDK 功能,以反映 Places API 的整體異動,這對 Android 和 iOS 這兩個行動平台都有影響:

  • Places Details (AndroidiOS) 要求會新增一項 fields 參數。
  • Autocomplete 的計費方式將以工作階段為準。

我們將在接下來的幾個月內提供更多詳細資料,包括遷移至新版 SDK 的時程和適當前置時間。這些新版本將會取代目前的 SDK 版本,我們會排定適當的淘汰時程,據此淘汰現行的 SDK。

Maps Elevation API

Google 地圖平台推出之後,新客戶必須與支援小組聯絡,才能存取 Maps Elevation API。目前使用這個 API 的無金鑰使用者請務必註冊 Google Cloud 帳戶,並盡速啟用 Maps Elevation API。

配額

新版每秒查詢次數 (QPS) 限制和用量上限

我們將取消每日配額上限 (QPD),大部分的服務都會改用額度較高的新版每秒查詢次數 (QPS) 限制。所有目前使用自助服務的客戶將自動轉換至採用新版 QPS 限制和用量上限。

API 目前預設用量上限 新版預設用量上限

Directions

100k QPD,50 QPS

50 QPS

Distance Matrix

100k EPD,100 EPS

1000 EPS

Elevation

100k QPD,50 QPS

100 QPS

Geocoding

100k QPD,50 QPS

50 QPS

Geolocation

100k QPD,50 QPS

100 QPS

Dynamic Maps

100k QPD

500 QPS

Static Maps

100k QPD

500 QPS

Street View Image API

100k QPD

500 QPS

Time Zone

100k QPD,50 QPS

500 QPS

Places (JavaScript 和網路)

150k QPD

100 QPS

Roads

100k QPD

500 QPS

*EPS = 每秒元素數,EPD = 每日元素數,QPS = 每秒查詢次數,QPD = 每日查詢次數

如果您是使用舊版預設 API 每日配額限制來防止要求次數超過配額,可以在 Google Cloud Platform Console 中新增專案的每日配額限制,這麼做即可維持原有的管理方式。瞭解詳情

品牌和產品名稱異動

品牌和產品名稱有何異動?

首先,我們已將品牌名稱改為 Google 地圖平台,平台包含您熟悉喜愛的 API (這些 API 跟以前相同)、簡化的計費方式,並提供可隨業務成長輕鬆調度資源的方法。此外,現在我們還為遊戲、代僱駕駛服務和資產追蹤產業,提供全方位的產業解決方案。Google 地圖在 200 多個國家/地區中服務超過 10 億名使用者,我們會持續向您提供範圍遍及全球的 Google 地圖基礎架構。

其次,我們已將 Google 地圖平台的 API 簡化為三項核心產品:地圖介面集、路徑介面集和地點介面集。各項核心產品中都包含多種功能,並由不同的 API 提供支援。如要查看各項產品的功能與 API,請造訪我們的說明文件頁面

再者,我們簡化了 API 和計費 SKU 的名稱,方便使用者搜尋及使用。詳情請見下方的新名稱列表。如要進一步瞭解新 SKU 的觸發方式,請參閱計費方式指南

API 名稱異動

舊名稱 新名稱

Google Maps Android API

Maps SDK for Android

Google Maps Directions API

Directions API

Google Maps Distance Matrix API

Distance Matrix API

Google Maps Geocoding API

Geocoding API

Google Maps Geolocation API

Geolocation API

Google Maps JavaScript API

Maps JavaScript API

Google Maps Roads API

Roads API

Google Maps SDK for iOS

Maps SDK for iOS

Google Maps Time Zone API

Time Zone API

Google Places API for Android

Places SDK for Android

Google Places API for iOS

Places SDK for iOS

Google Places API Web Service

Places API

Google Static Maps API

Maps Static API

Google Street View Image API

Street View API

Places Library in the Maps JavaScript API

Places Library、Maps JavaScript API

計費 SKU 名稱異動

產品 計費 SKU:新名稱 說明

地圖介面集

Static Maps

顯示靜態地圖。加入自訂標記、線條、色彩、多邊形和圖片等多種不同樣式。

Dynamic Maps

顯示互動式地圖。縮放、雙指撥動、旋轉及傾斜地圖,可探索更多細節與樣式。

Static Street View

顯示靜態街景服務、360 度全景圖片或是縮圖。

Dynamic Street View

顯示互動式街景服務、360 度全景圖片或是縮圖。

路徑介面集

Directions

取得開車、步行、單車和大眾運輸路線,並建立最多包含 10 個路線控點的路徑。

Directions Advanced

取得多模式路線,建立包含最多 25 個路線控點的路徑,並得知即時路況。

Distance Matrix

提供前往一或多個地點的交通時間和距離。

Distance Matrix Advanced

在考量即時路況的情況下,提供前往一或多個地點的交通時間和距離。

Roads - Route Traveled

透過判斷行經的路徑建立行程,收集路徑上最多 100 個 GPS 點。

Roads - Nearest Road

透過多達 100 個獨立座標判斷最近的道路。

地點介面集

Basic Data

提供超過 1 億個地點和搜尋點的名稱及地址。

Contact Data

提供超過 1 億個地點和搜尋點的名稱、地址及聯絡資訊。

Atmosphere Data

提供超過 1 億個地點和搜尋點的名稱、地址和聯絡資訊,以及豐富的詳細資料,例如評分和氣氛情調。

Places Photo

存取數百萬張相片,為地點和搜尋點新增高畫質相片。

Places - Text Search

根據搜尋字串 (例如「壽司餐廳」) 傳回附近地點清單。

Places - Nearby Search

根據使用者的所在位置傳回附近地點清單。

Find Place

將電話號碼、地址或名稱轉換為地點,並提供該地點的名稱和地址。

Autocomplete with Details

使用 Places Details 自動提供地點建議。

Autocomplete - Per Request

使用者輸入地址或地點名稱時,自動完成地點建議。按輸入的字元計費。

Autocomplete - Per Session

使用者輸入地址或地點名稱時,自動完成地點建議。按工作階段計費。

Geolocation

根據 Wi-Fi 或行動電話基地台的訊號,傳回裝置的位置和準確半徑。

Geocoding

將地址轉換成地理座標,或將地理座標轉換成地址。

Time Zone

根據地理座標和日期傳回任何位置的時區。

啟用 Google 地圖平台

啟用 API 或設定帳單的逐步操作說明如下:

  1. 在下方選擇產品
  2. 選擇專案
  3. 設定您的帳單

建構自訂的地圖體驗,帶給使用者身歷其境的感受。

協助使用者規劃往來各地的最佳交通方式。

提供豐富詳盡的資料,協助使用者探索全世界。

繼續