街景服務要求與回應

「街景服務圖片」要求是 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 表示指南針方向 相機上可接受的值為 0360 (兩個值表示北方,90 表示東方,而 180 南方)。如果未指定標題,則值為 計算相機朝指定方向 location,最晚相片拍攝地點的起點 。
  • fov (預設值為 90) 會決定圖片的水平視野 (以度為單位), 允許最大值為 120。 處理固定大小的可視區域時,如同 設定大小, 基本視野代表縮放,數字越小表示 指出縮放等級較高。


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

  • pitch (預設值為 0) 會指定相機相對於街景服務的向上或向下角度 。這通常是水平角色,不過不總是如此。正值 將相機向上調整 (90 度表示直線向上); 負值角度使相機向下 (-90 表示) 垂直向下)。
  • radius (預設值為 50) 設定半徑 (以公尺為單位),以搜尋全景。 以指定的經緯度為中心有效值不得為負數 整數值。
  • return_error_code 表示 API 是否應傳回 找不到圖片時顯示錯誤代碼 (404 找不到),或以回應 無效請求 (400 無效請求)。有效值為 truefalse。如果設為「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 (找不到) 錯誤,而非一般的灰色圖片。 指定位置。
  • 索取街景服務圖片中繼資料 判斷指定位置是否可使用圖像 以便傳送要求