Google Maps Platform 即将推出全新地图样式。此次地图样式更新包括全新默认调色板，以及地图体验和易用性方面的改进。所有地图样式将于 2025 年 3 月自动更新。如需详细了解适用范围以及如何提前选择启用，请参阅全新 Google Maps Platform 地图样式。

此页面由 Cloud Translation API 翻译。

街景

请选择平台： Android iOS JavaScript

借助 Google 地图街景，您可以通过 360 度的街道级图像探索世界各地。您可以探索世界各地的地标、观赏自然景观、浏览行程或展示您商家的外景。

概览

Google 街景提供整个覆盖区域内以指定道路为中心的 360 度全景视图。通过该 SDK 提供的覆盖范围与 iOS 版 Google 地图应用或 https://maps.google.com/ 的覆盖范围相同。请参阅街景简介，详细了解街景，并在交互式地图上查看支持的区域。

Maps SDK for iOS 提供了用于获取和处理 Google 地图街景中使用的图像的街景服务。街景图像以全景图片的形式返回，可在街景查看器（一个 GMSPanoramaView 类型的对象）中查看。

街景全景图片

每张街景全景图片都是一个或一组图片，提供以单个位置为中心的 360 度全景视图。图片符合等距柱状 (Plate Carree) 投影，包含 360 度水平视图（完整环绕一周）和 180 度垂直视图（从直上至直下）。生成的 360 度全景图片定义了一个球面投影，其图像包绕在该球面的二维表面上。

您可以使用 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];

通过网址架构启动街景

用户可在 iOS 版 Google 地图应用中查看 Google 街景图像。您可以将 mapmode 参数设置为 streetview，从而使用 comgooglemaps 网址架构在街景模式下启动 iOS 版 Google 地图应用。下面是一个将启动街景的网址示例。如需了解详情，请参阅网址架构文档。

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 度，垂直向下，与默认倾斜度正交）。

放大

街景支持通过使用缩放显示不同级别的图像细节。您可以通过编程方式设置缩放级别，用户也可以通过双指张合进行缩放来更改查看器中的级别。

移动镜头

创建 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: 方法来为过渡添加动画效果。另外，您也可以利用Core Animation控制镜头。这通过 GMSPanoramaView、GMSPanoramaLayer 上的自定义 CALayer 提供。

街景中的标记

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 上的方法列表。