Tài liệu tham khảo về lớp GMStoàn cảnhView

Tài liệu tham khảo về lớp GMStoànView

Tổng quan

Ảnh toàn cảnh được dùng để hiển thị hình ảnh trong Chế độ xem đường phố.

Bạn phải tạo bản dựng này thông qua [[GMSPanoramaView alloc] initWithFrame:] và được định cấu hình sau khi khởi chạy.

Bạn phải truy cập vào tất cả các thuộc tính và phương thức trên luồng chính, tương tự như mọi đối tượng UIKit. Các phương thức GMSPanoramaViewDelegate cũng sẽ chỉ được gọi lại trên luồng chính.

backgroundColor của chế độ xem này hiển thị trong khi không có ảnh toàn cảnh nào hiển thị, chẳng hạn như trong khi đang tải hoặc nếu ảnh toàn cảnh sau đó được đặt thành giá trị không. Màu alpha của backgroundColor không được hỗ trợ.

Hàm thành viên công khai

(void) setAllGesturesEnabled:
 Đặt tuỳ chọn bật (mặc định) hay tắt tất cả cử chỉ.
(void) animateToCamera:animationDuration:
 Tạo hiệu ứng chuyển động cho máy ảnh của GMSPanoramaView này thành camera, trong duration (được chỉ định bằng giây).
(void) updateCamera:animationDuration:
 Sửa đổi máy ảnh theo cameraUpdate, trong duration (được chỉ định tính bằng giây).
(void) moveNearCoordinate:
 Yêu cầu ảnh toàn cảnh gần coordinate.
(void) - moveNredCoordinate:namespace:
 Tương tự như moveNearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate.
(void) moveNearCoordinate:source:
 Tương tự như moveNearCoordinate: nhưng cho phép chỉ định một nguồn gần coordinate.
(void) - moveNearCoordinate:radius:source:
 Tương tự nhưmoveNearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate và một nguồn.
(void) moveTotoàn cảnhID:
 Yêu cầu ảnh toàn cảnh bằng panoramaID.
(CGPoint)pointForOrientation:
 Đối với khung hiển thị hiện tại, hãy trả về màn hình trỏ orientation trỏ qua.
(GMSOrientation)OrientationForPoint:
 Cho một điểm của khung hiển thị này, trả về hướng máy ảnh hiện tại trỏ qua vị trí màn hình đó.

Hàm thành viên công khai tĩnh

(loại thực thể)+ panoramaWithFrame:nearCoordinate:
 Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.
(loại thực thể)+ panoramaWithFrame:nearCoordinate:radius:
 Tương tự như toàn cảnhWithFrame:nearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate.
(loại thực thể)+ panoramaWithFrame:nearCoordinate:source:
 Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.
(loại thực thể)+ panoramaWithFrame:nearCoordinate:radius:source:
 Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.

Thuộc tính

GMSPanoramaToàn cảnh
 Ảnh toàn cảnh để hiển thị; đặt nó sẽ chuyển sang ảnh toàn cảnh mới.
Mã IBOutlet
< GMSPanoramaViewDelegate >
uỷ quyền
 Ủy quyền GMSPanoramaView.
CẢM ƠNorientationGestures
 Kiểm soát việc bật (mặc định) hay tắt cử chỉ hướng.
CẢM ƠNzoomGestures
 Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ thu phóng.
CẢM ƠNnavigationGestures
 Kiểm soát việc bật (mặc định) hay tắt cử chỉ điều hướng.
CẢM ƠNnavigationLinksHidden
 Kiểm soát việc các đường liên kết điều hướng có thể nhấn sẽ bị ẩn hay hiển thị (mặc định).
CẢM ƠNstreetNamesHidden
 Kiểm soát việc hiện hoặc hiển thị lớp phủ tên đường phố (mặc định).
GMSPanoramaCameramáy ảnh
 Điều khiển máy ảnh của ảnh toàn cảnh.
GMSPanoramaLayerlớp
 Trình truy cập cho loại CALayer tuỳ chỉnh dùng cho lớp.

Tài liệu về hàm thành phần

– (vô hiệu) setAllGesturesEnabled: (BOOL)  đã bật

Đặt tuỳ chọn bật (mặc định) hay tắt tất cả cử chỉ.

Điều này không hạn chế chuyển động có lập trình của máy ảnh hoặc chế độ kiểm soát ảnh toàn cảnh.

– (vô hiệu) animateToCamera: (GMSPanoramaCamera *) máy ảnh
AnimationDuration (Thời lượng hoạt ảnh): (Khoảng thời gian NSTime) thời lượng

Tạo hiệu ứng chuyển động cho máy ảnh của GMSPanoramaView này thành camera, trong duration (được chỉ định bằng giây).

– (vô hiệu) updateCamera: (GMSPanoramaCameraUpdate *) cameraUpdate
AnimationDuration (Thời lượng hoạt ảnh): (Khoảng thời gian NSTime) thời lượng

Sửa đổi máy ảnh theo cameraUpdate, trong duration (được chỉ định tính bằng giây).

- (vô hiệu) moveNearCoordinate: (CLLocationCoordinate2D)  tọa độ

Yêu cầu ảnh toàn cảnh gần coordinate.

Sau khi hoàn thành thành công,, nạp tiền Ảnh toàn cảnh :tGMSPanoramaViewDelegate

Đối với lỗi Ảnh toàn cảnhView:error:onMoveNearCoordinate: sẽ được gửi.

Các lệnh gọi lặp lại đến moveNearCoordinate: khiến các quá trình chuyển đổi đang chờ xử lý trước đó (không hoàn tất) bị huỷ – chỉ những lần chuyển đổi gần đây nhất củamoveNearCoordinate: và moveTotoànId: sẽ tiếp tục và tạo sự kiện.

- (vô hiệu) moveNearCoordinate: (CLLocationCoordinate2D)  tọa độ
bán kính: (NSUInteger) bán kính

Tương tự như moveNearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate.

- (vô hiệu) moveNearCoordinate: (CLLocationCoordinate2D)  tọa độ
nguồn tin: (GMSPanoramaSource) nguồn

Tương tự như moveNearCoordinate: nhưng cho phép chỉ định một nguồn gần coordinate.

API này đang trong giai đoạn thử nghiệm và không phải lúc nào cũng lọc theo nguồn.

- (vô hiệu) moveNearCoordinate: (CLLocationCoordinate2D)  tọa độ
bán kính: (NSUInteger) bán kính
nguồn tin: (GMSPanoramaSource) nguồn

Tương tự nhưmoveNearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate và một nguồn.

API này đang trong giai đoạn thử nghiệm và không phải lúc nào cũng lọc theo nguồn.

– (vô hiệu) moveTotoàn cảnhID: (NSString *) panoramaID

Yêu cầu ảnh toàn cảnh bằng panoramaID.

Sau khi hoàn thành thành công, nạp tiền Ảnh toàn cảnh :GMSPanoramaViewDelegate

Đối với lỗi Ảnh toàn cảnh 360 độ:error:onMoveToImageID: sẽ được gửi.

Các lệnh gọi lặp lại đến keepTocảnhID: kết quả là các quá trình chuyển đổi đang chờ xử lý trước đó (không hoàn tất) bị huỷ -- chỉ những chuyển đổi gần đây nhất của moveNearCoordinate: và moveTo AnalyticsId: sẽ tiếp tục và tạo ra các sự kiện.

Chỉ hỗ trợ mã toàn cảnh lấy từ SDK Google Maps dành cho iOS.

– (CGPoint) pointForOrientation: (GMSOrientation) hướng

Đối với khung hiển thị hiện tại, hãy trả về màn hình trỏ orientation trỏ qua.

Giá trị này có thể nằm ngoài chế độ xem đối với các hướng nhìn về phía trước đủ xa so với hướng thẳng về phía trước.

Kết quả sẽ chứa NaN cho hướng máy ảnh trỏ ra khỏi chế độ xem, trong đó điểm màn hình ngụ ý sẽ có khoảng cách âm so với máy ảnh theo hướng.

– (GMSOrientation) OrientationForPoint: (CGPoint) điểm

Cho một điểm của khung hiển thị này, trả về hướng máy ảnh hiện tại trỏ qua vị trí màn hình đó.

Ở giữa khung hiển thị này, GMSOrientation được trả về sẽ xấp xỉ bằng với GMSPanoramaCamera hiện tại.

+ (instancetype) toàn cảnhWithFrame: (CGRect) khung
Gần Tọa độ: (CLLocationCoordinate2D)  tọa độ

Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.

Thao tác này sẽ thực hiện hành động tương tự như của moveNearCoordinate: và sẽ gọi các phương thức uỷ quyền tương tự.

+ (instancetype) toàn cảnhWithFrame: (CGRect) khung
Gần Tọa độ: (CLLocationCoordinate2D)  tọa độ
bán kính: (NSUInteger) bán kính

Tương tự như toàn cảnhWithFrame:nearCoordinate: nhưng cho phép chỉ định bán kính tìm kiếm (mét) xung quanh coordinate.

+ (instancetype) toàn cảnhWithFrame: (CGRect) khung
Gần Tọa độ: (CLLocationCoordinate2D)  tọa độ
nguồn tin: (GMSPanoramaSource) nguồn

Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.

Thao tác này sẽ thực hiện một hành động tương tự như hành động củamoveNearCoordinate:source và sẽ gọi cùng một phương thức uỷ quyền.

API này đang trong giai đoạn thử nghiệm và không phải lúc nào cũng lọc theo nguồn.

+ (instancetype) toàn cảnhWithFrame: (CGRect) khung
Gần Tọa độ: (CLLocationCoordinate2D)  tọa độ
bán kính: (NSUInteger) bán kính
nguồn tin: (GMSPanoramaSource) nguồn

Hàm khởi tạo tiện lợi cho GMSPanoramaView, giúp tìm kiếm và hiển thị GMSPanorama gần coordinate.

Thao tác này sẽ thực hiện một hành động tương tự như hành động củaMoveNearCoordinate:tuệ bán kính:source và sẽ gọi cùng một phương thức uỷ quyền.

API này đang trong giai đoạn thử nghiệm và không phải lúc nào cũng lọc theo nguồn.


Tài liệu về thuộc tính

- (GMSPanorama*) toàn cảnh [read, write, assign]

Ảnh toàn cảnh để hiển thị; đặt nó sẽ chuyển sang ảnh toàn cảnh mới.

Đây là ảnh động, ngoại trừ ảnh toàn cảnh ban đầu.

Có thể đặt thành nil để xoá chế độ xem.

- (mã IBOutlet<GMSPanoramaViewDelegate>) uỷ quyền [read, write, assign]

Ủy quyền GMSPanoramaView.

– (BOOL) orientationGestures [read, write, assign] (Chỉ hướng)

Kiểm soát việc bật (mặc định) hay tắt cử chỉ hướng.

Nếu được bật, người dùng có thể sử dụng cử chỉ để thay đổi hướng của máy ảnh.

Điều này không hạn chế khả năng di chuyển có lập trình của camera.

– (BOOL) zoomGestures [read, write, assign] (Cử chỉ thu phóng)

Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ thu phóng.

Nếu bạn bật tính năng này, người dùng có thể chụm để thu phóng máy ảnh.

Điều này không hạn chế khả năng di chuyển có lập trình của camera.

- (BOOL) navigationGestures [read, write, assign]

Kiểm soát việc bật (mặc định) hay tắt cử chỉ điều hướng.

Nếu được bật, người dùng có thể nhấn một lần vào đường liên kết điều hướng hoặc nhấn đúp vào chế độ xem để thay đổi ảnh toàn cảnh.

Điều này không giới hạn quyền kiểm soát có lập trình đối với ảnh toàn cảnh.

– (BOOL) navigationLinksHidden [read, write, assign]

Kiểm soát việc các đường liên kết điều hướng có thể nhấn sẽ bị ẩn hay hiển thị (mặc định).

Không thể nhấn vào các đường liên kết điều hướng ẩn.

– (BOOL) streetNamesHidden [read, write, assign]

Kiểm soát việc hiện hoặc hiển thị lớp phủ tên đường phố (mặc định).

– (GMSPanoramaCamera*) máy ảnh [read, write, assign]

Điều khiển máy ảnh của ảnh toàn cảnh.

Việc đặt camera mới tại đây sẽ chuyển đến giá trị camera mới mà không có ảnh động.

– (GMSPanoramaLayer*) lớp [read, retain]

Trình truy cập cho loại CALayer tuỳ chỉnh dùng cho lớp.