簡介
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=<YOUR_SIGNATURE>
或按讚:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_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" |
表示伺服器發生錯誤,因此無法處理要求。 這個問題通常是暫時性的。如果您再試一次,該要求可能會成功。 |
更多資訊
如要進一步瞭解 Street View Static API,或 其他 Google Maps API 產品 別忘了查看 Maps API 的 支援網頁。