Google Street View Image API

簡介

Google Street View Image API 能讓您在不使用 JavaScript 的情況下，將靜態（非互動式）的「街景服務」全景或縮圖內嵌到您的網頁中。檢視點是以透過標準 HTTP 要求傳送的 URL 參數所定義，並會以靜態影像的形式傳回。

您所在的地區可能無法提供示範應用程式。

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

URL 參數

「街景服務影像」要求是具有下列格式的 HTTP URL：

https://maps.googleapis.com/maps/api/streetview?parameters

影像是使用要求參數指定。根據 URL 標準，所有參數都使用 & 字元來分隔。允許的參數與其可能值如下所示。

必要參數

可以是：

• location 可以是文字字串（例如 Chagrin Falls, OH）或緯度/經度值 (40.457375,-80.009353)。Google Street View Image API 將會貼齊至最接近此位置的全景相片。提供地址文字字串時，API 可能會使用不同的相機位置以更好的方式顯示指定位置。提供緯度/經度時，API 會搜尋半徑 50 公尺內的區域，以取得最接近此位置的相片。由於「街景服務」影像會定期重新整理，而每次拍攝相片的位置可能有些不同，因此當影像更新時，您的 location 可能會貼齊至不同的全景。

或：

• pano 是特定全景 ID。這些參數一般是穩定的。

以及：

• size 會以像素指定輸出影像的大小。大小會以 {width}x{height} 指定 - 例如，size=600x400 將會傳回一個寬度為 600 像素且高度為 400 像素的影像。
• key 可讓您在 Google API Console 中監視應用程式的 API 使用狀況、提供充足的免費每日配額，以及確保 Google 可以視需要就您的應用程式相關問題與您聯絡。如需詳細資訊，請參閱取得金鑰與簽章。

  注意：Google Maps APIs Premium Plan 客戶可能會在您的 街景服務 要求中使用 API 金鑰與數位簽章，或是有效的用戶端編號與數位簽章。如需詳細資訊，請參閱 Premium Plan 客戶的驗證參數。

  擁有「舊版」Google Maps APIs for Work 授權的客戶，必須在要求中包含有效的 client 與 signature 參數，而非 key。如需詳細資訊，請參閱《取得金鑰與簽章》頁面的用戶端 ID 與簽章一節。

選擇性參數

• signature （建議）是一個數位簽章，它是用來驗證使用您的 API 金鑰產生要求的所有網站，是否擁有正確的授權。注意：如果您啟用計費，「數位簽章是必要項目」。如果您超出地圖載入數的免費每日限制，當日剩餘的額外地圖載入數將會列入計費。沒包含數位簽章的計費地圖載入將會失敗。如需詳細資訊，請參閱取得金鑰與簽章。

  注意：針對 Google Maps APIs Premium Plan 客戶，「數位簽章是必要項目」。如需詳細資訊，請參閱 Premium Plan 客戶的驗證參數。

• heading 指出相機的指南針方向。接受的值從 0 到 360 （這兩個值皆表示北方，而 90 表示東方，180 則表示南方）。如果沒有指定方向，則會從最接近的已拍攝相片地點，計算出一個與相機面對指定 location 之方向相同的值。
• fov （預設為 90）能判斷影像的水平視野。視野是以度數來表達，允許的上限是 120。和處理特定大小的「街景服務」影像相同，處理固定大小的檢視點時，視野基本上便代表縮放，值越小表示縮放的程度越高。

  
  
  （左：fov=120，右：fov=20）

  您所在的地區可能無法提供示範應用程式。

• pitch （預設為 0）指定相機相對於「街景服務」車輛的上下角度。這個值通常是完全水平的。正值會提升相機角度（90 度為垂直向上），負值會降低相機角度（-90 度為垂直向下）。

範例要求顯示如下。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY

您所在的地區可能無法提供示範應用程式。

無可用影像

針對無可用街景服務影像的位置，Google Street View Image API 會傳回灰色的一般映像，並顯示文字：「很抱歉，這裡沒有影像」。

圖：在指定位置沒有可用影像時所顯示的一般映像。

您所在的地區可能無法提供示範應用程式。

如果要避免這種情況，您可以透過要求街景服務影像中繼資料來判斷指定位置是否有可用影像，以及有關映像的其他資料。

更多資訊

如果要取得使用 Google Street View Image API 或其他 Google Maps API 產品的詳細資訊，請務必查看 Maps API 支援頁面。