街景服務要求與回應

「街景服務圖片」要求是 HTTP 網址，格式如下：

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

圖像是使用 request 參數而設定的。按照標準 網址，所有參數都會以 & 字元分隔。 以下列出允許的參數以及可能的值。

必要參數

：

  • location 可以是文字字串，例如 Chagrin Falls, OH 或是經緯度座標組合 (40.457375,-80.009353)， 且應經過網址編碼。轉換 地址，例如「City Hall, New York, NY」 至「City+Hall,New+York,NY」再傳送要求 Street View Static API 會對齊最接近 位置。提供地址文字字串時，API 可能會使用 不同的相機位置，以更準確地顯示指定位置。 提供經緯度座標時，API 會搜尋 50 公尺半徑，找出最靠近該地點的相片。 這是因為街景服務圖像會定期更新，而且相片可能會 每次曝光的位置稍有不同 圖像更新後，您的 location 可能會對齊其他全景。

或：

  • pano 是特定的全景 ID。全景相片可能會隨著時間變更 ID， 請勿保留這個 ID請改為儲存地點地址。 經緯度座標，讓您可以重新整理全景 ID。適用對象 詳情請參閱重新整理已刪除的全景 ID。

以及：

  • size 會指定圖片的輸出大小 (以像素為單位)。大小指定為 {width}x{height}：例如：size=600x400 就會傳回一個寬度為 600 像素、高度 400 的圖片
  • key 可讓您監控應用程式的 API 用量，方法是使用 Google Cloud 控制台、 並確保 Google 可在必要時就申請與您聯絡。 詳情請參閱「取得金鑰和簽名」。

重新整理已刪除的全景 ID

如果您嘗試擷取全景 ID，且取得 ZERO_RESULTS 或 沒有值，那麼全景 ID 已經刪除，需要重新整理。

  1. 儲存地點的地址或經緯度座標 取得全景 ID，您可以在需要時重新整理影片。

  2. 發現全景 ID 已變更時，請使用原始位置 地址或經緯度座標，再次搜尋距離最近的 的全景拍攝，並取得新的全景 ID。

選用參數

  • signature (建議) 是您使用的數位簽章 ，驗證使用 API 金鑰產生要求的所有網站都已獲得授權 。未包含數位簽名的要求可能會失敗。 詳情請參閱「取得金鑰和簽名」。

    注意：適用於先前使用 Google 地圖平台付費方案的客戶，也就是數位 無須簽收。進一步瞭解 驗證參數 付費方案客戶。

  • heading 表示指南針方向 相機上可接受的值為 0 到 360 (兩個值表示北方，90 表示東方，而 180 南方)。如果未指定標題，則值為 計算相機朝指定方向 location，最晚相片拍攝地點的起點 。
  • fov (預設值為 90) 會決定圖片的水平視野 (以度為單位)， 允許最大值為 120。 處理固定大小的可視區域時，如同 設定大小, 基本視野代表縮放，數字越小表示 指出縮放等級較高。


    寬廣視野的螢幕截圖，當中展示水族箱內的天花板、牆壁、地板和坦克窗。 特寫鏡頭的螢幕截圖，顯示水族箱內部的街景服務相片放大細節。
    (左：fov=120；右：fov=20)

  • pitch (預設值為 0) 會指定相機相對於街景服務的向上或向下角度 。這通常是水平角色，不過不總是如此。正值 將相機向上調整 (90 度表示直線向上)； 負值角度使相機向下 (-90 表示) 垂直向下)。
  • radius (預設值為 50) 設定半徑 (以公尺為單位)，以搜尋全景。 以指定的經緯度為中心有效值不得為負數 整數值。
  • return_error_code 表示 API 是否應傳回 找不到圖片時顯示錯誤代碼 (404 找不到)，或以回應 無效請求 (400 無效請求)。有效值為 true 和 false。如果設為「true」，系統會顯示錯誤訊息 並取代一般的灰色圖片。因此您無須 請另外呼叫來檢查圖片可用性。
  • source (預設值為 default) 將街景服務搜尋範圍限制在特定來源。有效的值包括：
    • default 會使用街景服務的預設來源。 搜尋範圍不限於特定來源
    • outdoor 會將搜尋範圍限制在室外集錦。室內 集合不會包含在搜尋結果中。請注意，室外全景可能不存在 字詞傳回。另請注意，搜尋只會傳回全景 您可依此判斷它們是在室內還是室外。例如： 我們不會傳回 PhotoSphere，因為無法辨識室內或室外大小。

這是要求範例。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
街道視角相片的螢幕截圖，顯示受電動的鐵路軌道。

沒有可用的圖像

Street View Static API 在不提供街景服務圖像的地點 會傳回一張灰色的一般圖片，同時附帶文字「很抱歉，我們沒有圖像 "，如以下範例所示：

在指定地點沒有可用圖像的情況下顯示的一般圖片螢幕截圖。背景是淺棕色，顯示文字「很抱歉，這裡沒有圖像」。
圖：如果 指定位置
。

僅顯示有效的圖片

避免顯示通用圖片，並確保您的網頁 只會顯示有效的 Street View Static API 圖片，請遵循這些 建議：

  • 將 return_error_code 參數設為 true。 這會導致 Street View Static API 傳回 404 NOT FOUND (找不到) 錯誤，而非一般的灰色圖片。 指定位置。
  • 索取街景服務圖片中繼資料 判斷指定位置是否可使用圖像 以便傳送要求