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

街景服務

選取平台： Android iOS JavaScript

Google 地圖街景服務提供 360 度的街景服務圖像，讓您探索世界各個角落。你可探索世界地標、查看自然遊覽者、旅遊行程，或是在商家外部展示商家。

總覽

Google 街景服務可讓您在指定道路的涵蓋區域進行 360 度全景檢視。透過 SDK 提供的涵蓋範圍與 Google 地圖 iOS 版應用程式或 https://maps.google.com/ 相同。如要進一步瞭解街景服務並在互動式地圖上查看支援區域，請參閱街景服務網站上的簡介。

Maps SDK for iOS 提供街景服務，以便取得及操控在 Google 街景服務中使用的圖像。街景服務圖片會以全景形式傳回，並從街景服務檢視器中檢視 (GMSPanoramaView 類型的物件)。

街景服務全景

每個街景服務全景都由一或多張圖片組成，提供單一位置完整的 360 度環景。圖片符合等距長方形投影，包含 360 度的水平視圖 (完整的環景) 與 180 度的垂直視圖 (由正上方到正下方)。產生的 360 度全景會將球體投影定義在球面的 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 網址配置啟動 Google 地圖 iOS 應用程式。啟動街景服務的網址範例如下。詳情請參閱網址配置說明文件。

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

街景服務位置和視角

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) 定義相機初始預設傾斜角度的「向上」或「向下」變異量，預設傾斜角度通常 (但不一定) 是水平(例如，在山上拍攝的圖片中，預設傾斜角度可能就不是水平)。垂直角度的測量值為正值 (往右移動至 +10 並朝預設方向向上傾斜 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 上的自訂 CALayer 在 GMSPanoramaLayer 提供。

在街景視圖中的標記

GMSPanoramaView 物件可顯示地圖標記。您可以在 GMSMapView 或 GMSPanoramaView 物件上設定對應的屬性，以使用同一個 GMSMarker 物件：

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 方法清單。