街景服務

選取平台： Android iOS JavaScript

您可以透過 Google 地圖街景服務，探索世界各地的 360 度街景圖像。你可以探索世界地標、欣賞自然奇觀、導航行程，或展示商家外觀。

付費功能：呼叫 Maps SDK for iOS 不會產生費用，但呼叫 Dynamic Street View 功能需要收費。詳情請參閱 Google 地圖平台 SKU 詳細資料。

總覽

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

Maps SDK for iOS 提供街景服務，以取得及操控在 Google 地圖街景服務中使用的圖像。街景服務圖片會以全景圖傳回，並透過街景服務檢視器 (GMSPanoramaView 類型的物件) 進行查看。

街景服務全景

每個街景服務全景都由一或多張圖片組成，提供單一位置完整的 360 度環景。圖片符合等距長方形 (Plate Carrée) 投影，包含 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 方法可讓您同時指定半徑和來源。

查看街景視圖圖像

新增街景服務檢視器

用於將觀察者的基本步驟是：

1. (一次性) 請按照「開始使用」一文的步驟取得 SDK、取得金鑰並新增必要的架構。
2. 建立或更新 ViewController。如果全景圖會在這個 View Controller 顯示時顯示，請務必在 loadView 方法中建立全景圖。
3. 使用 GMSPanoramaView initWithFrame: 方法建立並例項化 GMSPanoramaView 類別。如果要將此畫面用於 View Controller 的唯一檢視畫面，則可使用 CGRectZero 做為地圖的框架，系統會自動調整地圖大小。
4. 將 GMSPanoramaView 物件設為 View Controller 的 View。例如 self.view = panoView;。
5. 使用 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];
      

使用網址配置啟動街景服務

您可以在 iOS 版 Google 地圖應用程式中查看 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) 定義相機初始預設傾斜角度的「向上」或「向下」變異量，預設傾斜角度通常 (但不一定) 是水平 (例如，在山上拍攝的圖片中，預設傾斜角度可能就不是水平)。傾斜角度的測量方式為正值朝上 (垂直向上 +90 度，並與預設傾斜角度成直角)，負值朝下 (垂直向下 -90 度，並與預設傾斜角度成直角)。

縮放

街景服務支援各種圖片精細度，只要使用縮放功能即可。您可以透過程式輔助方式設定縮放等級，或是讓使用者透過雙指撥動來變更檢視器中的等級。

移動攝影機

建立 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 位置之間的距離進行調整。如果這個距離太長，標記就會變得太小而無法顯示，並且會從檢視畫面中隱藏。

注意： 使用 GMSPanoramaView 時，並非所有標記功能皆可用。

將 panoramaView 屬性設為 nil，即可將其從 GMSPanoramaView 中移除。

Swift

marker.panoramaView = nil
      

Objective-C

marker.panoramaView = nil;
      

事件

您可以監聽街景服務全景上發生的事件，例如使用者輕觸全景時。如要監聽事件，您必須導入 GMSPanoramaViewDelegate 通訊協定。請參閱整體事件指南和 GMSPanoramaViewDelegate 上的各項方法。