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

此页面由 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 度全景图片定义了一个球面投影，其中图片包绕在该球面的二维表面上。

您可以使用 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 上的自定义 CALayer 提供，GMSPanoramaLayer。

街景中的标记

GMSPanoramaView 对象能够显示地图标记。您可以通过设置 GMSMapView 或 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 上的相关方法列表。