本頁面由 Cloud Translation API 翻譯而成。

街景服務圖片中繼資料

簡介

Street View Static API 中繼資料要求會提供 Street View 的相關資料查看全景。中繼資料可協助你確認街景服務圖像是否才能使用 Google Cloud 的 Ad Exchange 服務經緯度座標、全景 ID、相片拍攝日期以及該圖片的著作權資訊存取中繼資料可讓您自訂應用程式中的錯誤行為。

Street View Static API 中繼資料要求費用。您要求中繼資料時，不會耗用任何配額。當您使用 Street View Static API：

提出街景服務圖像中繼資料要求時，全景圖像準確為 50 公尺

存取圖像中繼資料

街景服務圖片中繼資料要求是採用下列格式的 HTTP 網址：

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

跟網址的標準一樣，這裡的所有參數都會以 & 符號分隔 (&) 字元。

中繼資料要求的必要參數

中繼資料要求接受相同的網址參數與 Street View Static API 圖像要求一樣，但只有必須提供以下參數：

：

location：可以是文字字串，例如 Chagrin Falls, OH 或一組經緯度座標 (40.457375,-80.009353)。

或：

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

以及：

key 和 signature：必須使用 API 金鑰來驗證請求。在某些情況下，我們也要求提供數位簽章。建議一律使用。若需更多資訊，請參閲取得金鑰和簽名。

只包含必要參數的中繼資料要求，如下所示：

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=

或按讚：

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

重新整理已刪除的全景 ID

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

儲存地點的地址或經緯度座標取得全景 ID，您可以在需要時重新整理影片。
發現全景 ID 已變更時，請使用原始位置地址或經緯度座標，再次搜尋距離最近的的全景拍攝，並取得新的全景 ID。

中繼資料要求的選用參數

您可以在中繼資料要求中加入下列參數：size、 heading、fov和pitch。請注意，這些參數不會影響或找到的全景相關資料。 API 允許加入與圖片要求更輕鬆地建立與特定圖像相關的中繼資料要求要求，但是對於中繼資料要求，API 會忽略選用的參數和每當某人做出決策其實就是根據自己價值觀做出選擇如要進一步瞭解如何使用這些參數，請參閱 Street View Static API 開發人員指南。

回應格式

中繼資料回應只會以 JSON 格式傳回。

範例

範例 1：找到全景

下列網址成功要求相同中繼資料和圖片全景。

中繼資料要求和回應

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

圖像要求和回應，請提供缺少的圖片。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

範例 2：找不到全景

下列網址要求該全景的中繼資料和圖片在指定位置或附近找不到。

中繼資料要求和回應

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

圖像要求和回應

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

狀態碼

中繼資料回應物件中的 status 欄位包含請求，並可能包含偵錯資訊，以協助您排解問題為何街景服務要求無法運作。status 欄位可能包含下列值：

狀態	說明
`"OK"`	表示未發生任何錯誤；找到全景，且中繼資料位於。
`"ZERO_RESULTS"`	表示提供的位置附近找不到全景。如果提供的全景 ID 不存在或無效，就可能發生這個回應。請參閱「[重新整理已刪除的全景 ID](#refresh-pano)。
`"NOT_FOUND"`	表示 `location` 中提供的地址字串找不到參數。如果地址不存在，就有可能出現這則訊息沒有什麼事
`"OVER_QUERY_LIMIT"`	表示您已超過每日配額或每秒配額。
`"REQUEST_DENIED"`	表示您的要求遭拒。要是您有不授權你的要求；或者 Street View Static API 並未啟用含有您 API 金鑰的 Google Cloud 控制台專案。
`"INVALID_REQUEST"`	通常會指出查詢參數 (address、經緯度座標或元件)。
`"UNKNOWN_ERROR"`	表示伺服器發生錯誤，因此無法處理要求。這個問題通常是暫時性的。如果您再試一次，該要求可能會成功。