您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Places API Web Service

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Places API Web Service
  3. 建立適當的金鑰
繼續

地點相片

「地點相片」服務(Google Places API Web Service 的一部分)是一個唯讀 API,可讓您將高品質的相片內容新增到您的應用程式。

「地點相片」服務可讓您存取儲存於「地方資訊」與「Google+ 在地服務」資料庫中的數百萬張相片。 當您使用「地點詳細資料」要求取得地方資訊時,將會傳回相關相片內容的相片參考資料。

「附近地點搜尋」與「文字搜尋」要求也會傳回各地點的單一相片參考資料(如有相關)。 使用相片服務,您可以存取參考相片以及將影像調整為符合您應用程式的最佳大小。

相片參考資料

所有「地點相片」服務要求都必須包括傳回的 photoreference,以回應「附近地點搜尋」、「文字搜尋」或「地點詳細資料」要求。

如果地點有相關的相片內容,則這些要求的回應會包含 photos[] 欄位。

注意: 傳回的相片數會依要求而不同。

  • 「附近地點搜尋」與「文字搜尋」最多會傳回陣列中的一個 photo 元素。

  • 「雷達搜尋」不會傳回任何相片資訊。

  • 「詳細資料」要求最多會傳回十個 photo 元素。

每一個 photo 元素都包含下列欄位:

  • photo_reference:當您執行相片要求時,用來識別相片的字串。

  • height:影像的高度上限。

  • width:影像的寬度上限。
  • html_attributions[]:包含任何必要的資料引用標示。 此欄位一律會存在,但可以為空白。

由相片服務所傳回的相片來自多個位置,包含商家擁有者與 Google+ 使用者所提供的相片。 在大部分情況中,這些相片不需要資料引用標示就能使用,或是將必要資料引用標示包括為影像的一部分。

然而,如果傳回的 photo元素包括 html_attributions 欄位中的值,則不論您在何處顯示該影像,都必須於應用程式中包含額外的資料引用標示。

photos[] 陣列的範例顯示如下。

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" :"CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

地點相片要求

「地點相片」要求是具有下列格式的 HTTP URL:

https://maps.googleapis.com/maps/api/place/photo?parameters

某些參數是起始搜尋要求的必要參數。 如同 URL 中的標準,所有參數皆使用 & 字元來分隔。 參數清單與其可能值列舉如下。

必要參數

  • key:您應用程式的 API 金鑰。 金鑰會依配額管理目的識別您的應用程式。 如需詳細資訊,請參閱 取得金鑰

  • photoreference:用來唯一識別相片的字串識別碼。 相片參考資料是由地點搜尋地點詳細資料要求傳回。

  • maxheightmaxwidth:指定「地點相片」服務所傳回之影像的期望高度或寬度上限(像素)。

如果影像小於指定值,則將會傳回原始影像。 如果影像的長或寬較大,則會將它調整為符合長寬兩者中較小者,將它限制為其原始外觀比例。

maxheightmaxwidth 屬性兩者接受 1 到 1600 之間的整數。

範例要求顯示如下。 要求會傳回參考影像,重新調整其大小最多為 400 像素寬。

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

注意:您必須取代此範例中的 API 金鑰,讓要求能在您的應用程式中運作。

地點相片回應

成功的地點相片要求之回應會是一個影像。 影像的類型視原始提交之相片的類型而定。

如果您的要求超過可用配額,伺服器會傳回 HTTP 403 狀態並顯示下列影像以表示已超過配額:

超過配額影像

如果伺服器無法理解您的要求,它會傳回 HTTP 400 狀態,指出無效的要求。 您可能遇到無效的要求最常見的原因包括:

  • 提交的相片參考資料指定錯誤。
  • 您的要求未包括 maxwidthmaxheight 參數。

錯誤訊息

當「地方資訊」服務傳回 HTTP 400 狀態,則在回應物件內可能有額外的 error_message 欄位。

此欄位包含有關狀態碼背後原因的更多詳細資訊。

sensor 參數

Google Places API Web Service 先前要求您包括 sensor 參數,以指出您的應用程式是否使用感應器來判斷使用者的位置。 現在已不再需要此參數。

傳送您對下列選項的寶貴意見...

這個網頁
location_on
Google Places API Web Service