選單

產品最新動態

我們更新了多項 API,詳情如下。

地圖

「地圖」產品沒有任何異動。請參閱 API 相關計費異動

路徑

「路徑」產品沒有任何異動。請參閱 API 相關計費異動

地方資訊

地點詳細資料要求可限制於特定欄位

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

所有地點詳細資料要求都將依基本費率收費。

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

address_componentadr_addressalt_idformatted_addressgeometryiconidnamepermanently_closedphotoplace_idplus_codescopetypeurlutc_offsetvicinity

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

formatted_phone_numberinternational_phone_numberopening_hourswebsite

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

price_levelratingreview

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

建議做法:

  • 評估您的應用程式,看看您正在使用哪個地點詳細資料的內容
  • 更新程式碼,加入 fields 參數
  • 登入 Google Cloud Platform 主控台,瞭解您目前的 Places API 使用情形 (如需主控台說明,請造訪 Google 帳戶說明中心)

範例

您可以使用 fields 參數指定地點詳細資料要求所傳回的欄位,如下列範例中所示 (指定欄位為 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); 

網路服務

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

建議做法:

考慮遷移您現有的地點搜尋要求,改用「尋找地點」服務。

JavaScript

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

建議做法:

考慮遷移您現有的文字搜尋要求,改用「尋找地點」服務。

範例

以下範例顯示搜尋「Museum of Contemporary Art Australia」(澳洲當代藝術博物館) 的 Places API 網路服務尋找地點要求,指定的欄位包括 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]);
    }
  }
}

地方資訊的 Mobile SDK

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

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

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

  • 地點詳細資料 (AndroidiOS) 要求將有一項新的 fields 參數。
  • 自動完成計費方式將以工作階段為準。

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

Maps Elevation API

Google Maps Platform 推出後,新客戶必須與支援小組聯絡,才能存取 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 主控台加入專案的每日配額限制,即可維持原來的措施。瞭解詳情

品牌和產品名稱異動

品牌和產品名稱有哪些變動?

首先,我們已將品牌名稱改為 Google Maps Platform,納入許多您熟知且常用的 API、簡化了計費方式,並提供可隨業務成長輕鬆調度資源的方法。此外,現在我們還為遊戲、代僱駕駛服務和資產追蹤產業,提供全方位的產業解決方案。Google 地圖在全球超過 200 個國家/地區服務超過 10 億名使用者。Google 地圖會持續為您提供涵蓋全球各地的廣大基礎架構。

其次,我們已將 Google Maps Platform 的 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:新名稱 說明

地圖

靜態地圖

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

動態地圖

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

靜態街景服務

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

動態街景服務

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

路徑

路線

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

進階路線

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

距離矩陣

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

進階距離矩陣

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

道路 - 行經的路徑

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

道路 - 最近的道路

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

地方資訊

基本資料

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

聯絡資料

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

氣氛資料

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

地點相片

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

地點 - 文字搜尋

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

地點 - 搜尋附近

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

尋找地點

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

使用詳細資料自動完成

使用「地點詳細資料」自動完成地點建議。

自動完成 - 按要求計費

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

自動完成 - 按工作階段計費

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

地理位置

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

地址定位

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

時區

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

啟用 Google Maps Platform

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

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

打造讓使用者身歷其境的自訂地圖體驗。

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

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

您現在已登入。
請按一下 [繼續] 以選取專案。
繼續 繼續 繼續 繼續 繼續 繼續 繼續