Google 地圖街景服務可讓您透過 360 度的街景圖像探索世界各地。您可以探索世界的地標、觀賞自然的低谷、導航旅行,或展示商家外面。
總覽
使用 Google 街景服務可在指定道路的涵蓋區域,進行 360 度全景檢視。SDK 提供的涵蓋範圍與 Google Maps iOS 版應用程式或 https://maps.google.com/
相同。如要進一步瞭解街景服務並在互動式地圖上查看支援區域,請參閱「街景服務簡介」一文。
Maps SDK for iOS 提供街景服務,以取得及操控在 Google 地圖街景服務中使用的圖像。街景服務圖片會以全景的形式傳回,並在街景服務檢視器中查看 (類型為 GMSPanoramaView
的物件)。
街景服務全景
每個街景服務全景都由一或多張圖片組成,提供單一位置完整的 360 度環景。圖片符合等距長方形 (Plate Carrée) 投影,包含 360 度的水平視圖 (完整環景) 與 180 度的垂直視圖 (由正上方到正下方)。接著,產生的 360 度全景會定義球體投影,並將圖片呈現到這個 SpO 的 2D 表面。
您可以使用 GMSPanoramaView
物件查看街景服務全景。這個物件提供的檢視器會將全景算繪為球體,攝影機則位於其中央。您可以透過程式輔助方式控制攝影機的方向,以及多個屬性自訂檢視器。
存取街景服務資料
街道視圖全景圖被確定了兩件的元數據中的一個:
panoramaID
- 街景服務全景的專屬 ID。這個
panoramaID
可能會隨時間改變,而且不適合作為長期或硬式編碼參照。panoramaID
最適合用來以程式輔助方式存取不同的街景服務圖片。 coordinate
- 這張圖片的精確位置,以
CLLocationCoordinate2D
表示。使用coordinate
永久儲存全景位置,或將地圖上的使用者動作轉譯為街景服務圖片。
panoramaID
和 coordinate
都會儲存為 GMSPanorama
物件的屬性。您可以使用 coordinate
或 panoramaID
,從 GMSPanoramaService
要求 GMSPanorama
。產生的物件會包含這兩件中繼資料,以及附近全景的連結陣列。
設定全景的位置
可根據座標設定街景服務全景的位置。
moveNearCoordinate
方法會要求該座標附近的全景。moveNearCoordinate:radius
方法與此類似,但可讓您指定座標周圍的搜尋半徑 (以公尺為單位)。moveNearCoordinate:source
方法可讓您指定來源。如果想要限制街景服務只尋找外部的全景,設定來源是個很實用的方法。在預設情況下,位置的全景可以是內部或外部。請注意,室外全景可能不適用於指定位置。moveNearCoordinate:radius:source
方法可讓您同時指定半徑和來源。
查看街景視圖圖像
新增街景服務檢視器
用於將觀察者的基本步驟是:
- (一次) 按照「入門指南」中的步驟取得 SDK,取得金鑰並新增必要架構。
- 建立或更新
ViewController
。如果這個檢視區塊控制器在可見時顯示,請務必在loadView
方法中建立全景。 - 使用
GMSPanoramaView
initWithFrame:
方法建立GMSPanoramaView
類別並例項化。如果這是用作檢視畫面控制器的唯一檢視畫面,則CGRectZero
可用來做為地圖的頁框,並且會自動調整地圖的大小。 - 將
GMSPanoramaView
物件設為檢視畫面控制器的檢視畫面,例如self.view = panoView;
。 - 請使用
moveNearCoordinate:
等方法設定街景服務圖像的位置。
下面的示例添加一個街景視圖查看器的應用程序。
Swift
import GoogleMaps class StreetView: UIViewController { override func loadView() { let panoView = GMSPanoramaView(frame: .zero) self.view = panoView panoView.moveNearCoordinate(CLLocationCoordinate2D(latitude: -33.732, longitude: 150.312)) } }
Objective-C
#import "StreetView.h" @import GoogleMaps; @interface StreetView () @end @implementation StreetView - (void)loadView { GMSPanoramaView *panoView = [[GMSPanoramaView alloc] initWithFrame:CGRectZero]; self.view = panoView; [panoView moveNearCoordinate:CLLocationCoordinate2DMake(-33.732, 150.312)]; } @end
自訂檢視器
您可以通過限制哪些手勢可定制的瀏覽器。根據預設,平移、縮放及移至相鄰的全景都會啟用。個別手勢是透過 GMSPanoramaView
的屬性控制。這些屬性會啟用或停用由使用者控管的手勢;停用手勢後,仍可進行程式輔助變更。
orientationGestures
- 使用者是否能以輕觸或拖曳的方式重設攝影機方向。設為
NO
即可停用相機的方向變更功能。 zoomGestures
- 指出使用者是否能以雙指撥動縮放。如要停用縮放功能,請設為
NO
。 navigationGestures
- 使用者是否可以更改要顯示的全景。使用者只要輕觸一下導覽連結,或輕觸兩下檢視畫面即可變更全景,設為
NO
則可停用導覽變更。
您可以使用 setAllGesturesEnabled:
方法一次啟用或停用所有手勢。
Swift
panoView.setAllGesturesEnabled(false)
Objective-C
[panoView setAllGesturesEnabled:NO];
透過網址配置推出街景服務
Google 街景服務圖像可在 iOS 版 Google 地圖應用程式中查看。將 mapmode
參數設為 streetview
,即可在街景服務模式下使用 comgooglemaps
網址配置,啟動 iOS 版 Google Maps for iOS 應用程式。下方顯示啟動街景服務的網址範例詳情請參閱網址配置說明文件。
comgooglemaps://?center=46.414382,10.013988&mapmode=streetview
街景服務位置和視角 (POV)
GMSPanoramaCamera
可讓您將街景服務相機的視角設為方向、傾斜和縮放的組合。
下面的代碼片段集將定向攝像頭向南,並稍微向下。
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180 pitch:-10 zoom:1];
方向
街景服務位置會定義圖片中相機焦點的位置,但不會定義圖片中相機的方向。為瞭解決這個問題,GMSOrientation
物件會定義兩個屬性:
heading
以正北為基準,定義相機擺放位置的旋轉角度 (以度為單位)。順時針測量方向:正北為 0,正東為 90,正南為 180,正西為 270。pitch
(預設為0
) 定義相機初始預設傾斜角度的「向上」或「向下」變異量,預設傾斜角度通常 (但不一定) 是水平(例如,在山上拍攝的圖片中,預設傾斜角度可能就不是水平)。傾斜角度的測量方式為正向上的正值 (垂直向上 +90 度,並與預設傾斜角度呈直角);負值朝下 (垂直向下 -90 度,並與預設傾斜角度呈直角) 測量。
Zoom
街景服務支援使用變焦功能,支援不同等級的圖片細節。您可以透過程式輔助方式設定縮放等級,使用者也能以雙指撥動縮放,變更檢視器中的縮放等級。
移動攝影機
建立 GMSPanoramaView
並且具有已設定或預設相機後,您可以透過下列幾種方式變更此設定。調整攝影機時,您可以選擇是否要為產生的攝影機動作加入動畫效果。動畫會插入在目前攝影機屬性和新攝影機屬性之間。
您可以修改 GMSPanoramaCamera
物件,並將其設定在 GMSPanoramaView
的 camera
屬性上。這可將攝影機對齊到沒有動畫的新視角。您可以建立 GMSCameraPosition
,用來設定方向和縮放的任意組合。
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180 pitch:-10 zoom:1];
您可以呼叫 GMSPanoramaView
的 animateToCamera:animationDuration:
方法,為轉場效果加上動畫效果。此外,您可以使用控制核心動畫的相機。此功能可透過 GMSPanoramaView
、GMSPanoramaLayer
上的自訂 CALayer
使用。
在街景視圖中的標記
GMSPanoramaView
物件可顯示地圖標記。您可以將同一個 GMSMarker
物件用於 GMSMapView
或 GMSPanoramaView
物件,只要設定對應的屬性即可:
Swift
// Create a marker at the Eiffel Tower let position = CLLocationCoordinate2D(latitude: 48.858, longitude: 2.294) let marker = GMSMarker(position: position) // Add the marker to a GMSPanoramaView object named panoView marker.panoramaView = panoView // Add the marker to a GMSMapView object named mapView marker.map = mapView
Objective-C
// Create a marker at the Eiffel Tower CLLocationCoordinate2D position = CLLocationCoordinate2DMake(48.858,2.294); GMSMarker *marker = [GMSMarker markerWithPosition:position]; // Add the marker to a GMSPanoramaView object named panoView marker.panoramaView = panoView; // Add the marker to a GMSMapView object named mapView marker.map = mapView;
標記的大小會縮放為標記位置與 GMSCameraView
位置之間的距離函式。如果這個距離太小,標記就會變得太小而無法顯示,且不會顯示在檢視畫面中。
將 panoramaView
屬性設為 nil
,即可從 GMSPanoramaView
中移除該屬性。
Swift
marker.panoramaView = nil
Objective-C
marker.panoramaView = nil;
活動
您可以監聽街景服務全景上發生的事件,例如使用者輕觸全景時。如要監聽事件,您必須實作 GMSPanoramaViewDelegate
通訊協定。請參閱完整的事件指南及 GMSPanoramaViewDelegate
中的方法清單。