Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Định cấu hình bản đồ

Chọn nền tảng: Android iOS

Phần tổng quan này mô tả cách định cấu hình bản đồ đã được thêm vào ứng dụng iOS bằng cách sử dụng SDK Maps dành cho iOS.

Tổng quan

Sau khi thêm bản đồ vào ứng dụng của mình, bạn có thể định cấu hình các tuỳ chọn ban đầu và chế độ cài đặt trong thời gian chạy của bản đồ. Để biết thông tin chi tiết về cách thêm vùng chứa bản đồ, hãy xem phần Thêm bản đồ.

Cài đặt bản đồ ban đầu bao gồm:

Vị trí máy ảnh, bao gồm: vị trí, thu phóng, đặt và nghiêng. Hãy xem phần Máy ảnh và chế độ xem để biết thông tin chi tiết về vị trí của máy ảnh.
Màu nền của bản đồ.
Loại bản đồ.
Các thành phần trên giao diện người dùng cần hiển thị, chẳng hạn như các nút thu phóng và la bàn.
Các cử chỉ cần bật.

Trong thời gian chạy, bạn có thể định cấu hình các chế độ cài đặt này và một số chế độ cài đặt bổ sung bằng cách cập nhật đối tượng GMSMapView.

Tùy chọn bản đồ

Khi khởi chạy chế độ xem bản đồ, các tuỳ chọn cấu hình được đặt bằng GMSMapViewOptions. Các thuộc tính tuỳ chọn bao gồm frame, camera, mapID hoặc backgroundColor.

Tùy chọn bản đồ
khung	Giá trị: `CGRect` Khung bản đồ. Giá trị mặc định là CGctZero.
máy ảnh	Giá trị: `GMSCameraPosition` Vị trí máy ảnh mặc định của bản đồ.
mapID	Giá trị: `GMSMapID` Mã bản đồ của Google. Tham số không bắt buộc.
backgroundColor	Giá trị: `UIColor` Giá trị mặc định là UIColor.lightGray

Định cấu hình tuỳ chọn bản đồ

Bạn có thể đặt các thuộc tính tuỳ chọn của riêng mình hoặc truyền trực tiếp một GMSMapViewOptions đã tạo với các giá trị mặc định đến GMSMapView.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Sau đây là ví dụ về cách truyền trực tiếp đối tượng GMSMapViewOptions có các giá trị mặc định đến GMSMapView.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Định cấu hình màu nền

Khi làm việc ở chế độ tối hoặc chuyển đổi giữa các chế độ xem bản đồ, bạn nên ghi đè màu nền mặc định của bản đồ. Bạn có thể thực hiện việc này bằng cách đặt thuộc tính backgroundColor của tuỳ chọn bản đồ.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Loại bản đồ

Bạn có thể tùy chỉnh bản đồ của mình với một trong vài loại bản đồ. Loại bản đồ chi phối cách thể hiện tổng thể của bản đồ. Ví dụ: tập bản đồ thường chứa bản đồ chính trị tập trung vào việc thể hiện ranh giới và bản đồ đường thể hiện tất cả các con đường của một thành phố hoặc khu vực. SDK Maps dành cho iOS cung cấp các loại bản đồ sau:

Loại bản đồ
Bình thường	Giá trị: `kGMSTypeNormal` Lộ trình điển hình. Hiển thị các con đường, một số đối tượng địa lý do con người xây dựng và các đối tượng tự nhiên quan trọng như sông. Nhãn đường và nhãn đối tượng cũng sẽ xuất hiện. Hỗ trợ việc đặt bảng phối màu của bản đồ thành tối, sáng hoặc tuân theo các chế độ cài đặt hệ thống.
Xe lai	Giá trị: `kGMSTypeHybrid` Dữ liệu ảnh chụp vệ tinh có thêm bản đồ đường đi. Nhãn đường và nhãn đối tượng cũng xuất hiện.
Vệ tinh	Giá trị: `kGMSTypeSatellite` Dữ liệu ảnh chụp vệ tinh. Nhãn đường và tính năng không hiển thị.
Địa hình	Giá trị: `kGMSTypeTerrain` Dữ liệu địa hình. Bản đồ bao gồm màu sắc, đường đồng mức, nhãn và tô bóng phối cảnh. Một số đường và nhãn cũng hiển thị. Hỗ trợ việc đặt bảng phối màu của bản đồ thành tối, sáng hoặc tuân theo các chế độ cài đặt hệ thống.
Không có	Giá trị: `kGMSTypeNone` Không có ô bản đồ nào. Các ô bản đồ cơ sở sẽ không được hiển thị. Chế độ này hữu ích khi kết hợp với lớp thẻ thông tin. Tính năng hiển thị dữ liệu giao thông sẽ bị tắt khi loại bản đồ được đặt thành không có.

Thay đổi loại bản đồ

Để đặt loại bản đồ, hãy gán một giá trị mới cho thuộc tính GMSMapView.mapType. Ví dụ: để hiển thị loại bản đồ vệ tinh:

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

Bộ chọn bên dưới hiển thị bản so sánh địa hình, bản đồ thông thường và bản đồ kết hợp cho cùng một vị trí:

Bản đồ trong nhà

Ở mức thu phóng cao, SDK Maps dành cho iOS sẽ hiển thị sơ đồ tầng cho không gian trong nhà như sân bay, trung tâm mua sắm, cửa hàng bán lẻ lớn và trạm phương tiện công cộng. Sơ đồ tầng trong nhà được tích hợp vào các ô bản đồ mặc định cho loại bản đồ "bình thường" (kGMSTypeNormal) và tự động bật khi người dùng phóng to và mờ đi khi bản đồ được thu nhỏ.

Bạn có thể tắt bản đồ trong nhà bằng cách đặt thuộc tính indoorEnabled của GMSMapView thành NO.

Swift

mapView.isIndoorEnabled = false

Objective-C

mapView.indoorEnabled = NO;

Ngoài ra, bạn có thể chỉ tắt chế độ kiểm soát Bộ chọn giá sàn.

Đang thêm sơ đồ tầng

Sơ đồ tầng có sẵn tại một số địa điểm. Nếu không có dữ liệu sơ đồ tầng cho một toà nhà mà bạn muốn đánh dấu trong ứng dụng của mình, thì bạn có thể:

Thêm trực tiếp sơ đồ tầng vào Google Maps. Điều này giúp kế hoạch của bạn hiển thị cho tất cả người dùng Google Maps.
Hiển thị sơ đồ tầng dưới dạng Lớp phủ mặt đất. Việc này chỉ cho phép người dùng ứng dụng xem sơ đồ tầng của bạn.

Lớp giao thông

Bạn có thể cho phép người dùng xem bản đồ với thông tin về mật độ giao thông được xếp chồng lên trên. Thao tác này cung cấp bản tóm tắt trực quan về tình hình giao thông địa phương của họ. Bạn có thể bật và tắt lớp lưu lượng truy cập bằng cách gọi phương thức trafficEnabled. Ví dụ sau cho thấy cách lớp giao thông có thể xuất hiện trên bản đồ.

Bản đồ Google hiển thị lớp giao thông

Hỗ trợ tiếp cận

Theo mặc định, các yếu tố hỗ trợ tiếp cận trên bản đồ sẽ bị ẩn. Bạn có thể bật tính năng hỗ trợ tiếp cận bằng cách đặt thuộc tính accessibilityElementsHidden của GMSMapView thành NO. Điều này khiến các phần tử hỗ trợ tiếp cận được tạo cho các đối tượng lớp phủ (chẳng hạn như GMSMarker và cửa sổ thông tin, GMSPolyline, v.v.).

Swift

mapView.accessibilityElementsHidden = false

Objective-C

mapView.accessibilityElementsHidden = NO;

Thuộc tính này theo giao thức UIAccessibility không chính thức, ngoại trừ giá trị mặc định trong SDK Maps dành cho iOS là YES.

Vị trí của tôi

Theo mặc định, dữ liệu vị trí sẽ không xuất hiện trên bản đồ. Bạn có thể bật dấu chấm và hướng la bàn "Vị trí của tôi" màu xanh dương bằng cách đặt myLocationEnabled trên GMSMapView.

Swift

mapView.isMyLocationEnabled = true

Objective-C

mapView.myLocationEnabled = YES;

Khi bật tính năng này, bạn sẽ cung cấp thông tin vị trí hiện tại của người dùng thông qua thuộc tính myLocation. Thuộc tính này có thể chưa có sẵn ngay – ví dụ: nếu người dùng được iOS nhắc cho phép truy cập vào dữ liệu này. Trong trường hợp này, giá trị là nil.

Swift

print("User's location: \(String(describing: mapView.myLocation))")

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);

Toà nhà 3D

Nhiều thành phố, khi được xem cận cảnh, sẽ có các toà nhà 3D có thể nhìn thấy được, như có thể xem trong hình Seattle, Washington dưới đây.

Bản đồ 3D các toà nhà ở Seattle, Washington.

Bạn có thể tắt toà nhà 3D bằng cách đặt thuộc tính GMSMapView tương ứng trong Swift hoặc Target-C, như minh hoạ dưới đây:

Swift

mapView.isBuildingsEnabled = false

Objective-C

[mapView setBuildingsEnabled:NO];

Khoảng đệm bản đồ

Google Maps được thiết kế để lấp đầy toàn bộ khu vực được xác định bởi GMSMapView. Một số khía cạnh của cách bản đồ xuất hiện và hoạt động được xác định bởi các kích thước của chế độ xem:

Mục tiêu của máy ảnh phản ánh chính giữa của vùng đệm.
Các thành phần điều khiển bản đồ được đặt tương ứng với các cạnh của bản đồ.
Thông tin pháp lý, chẳng hạn như tuyên bố về bản quyền hoặc biểu trưng của Google sẽ xuất hiện dọc theo cạnh dưới của bản đồ.

Bạn có thể thêm khoảng đệm xung quanh các cạnh của bản đồ bằng cách sử dụng GMSMapView.Thuộc tính padding. Bản đồ tiếp tục lấp đầy toàn bộ vùng chứa, nhưng văn bản và thành phần điều khiển vị trí, cử chỉ trên bản đồ và di chuyển của máy ảnh hoạt động như thể bản đồ được đặt trong một không gian nhỏ hơn. Điều này dẫn đến những thay đổi sau:

Chuyển động của camera bằng lệnh gọi API hoặc thao tác nhấn nút (ví dụ: la bàn, vị trí của tôi) có liên quan đến vùng đệm.
GMSMapView.projection trả về một phép chiếu chỉ bao gồm vùng đệm.
Các thành phần điều khiển trên giao diện người dùng được bù trừ từ cạnh của vùng chứa theo số điểm đã chỉ định.

Khoảng đệm có thể hữu ích khi thiết kế giao diện người dùng chồng chéo lên một phần bản đồ. Ví dụ: trong hình ảnh, bản đồ được đệm dọc theo các cạnh trên cùng và bên phải. Các thành phần điều khiển bản đồ hiển thị và văn bản pháp lý được hiển thị dọc theo các cạnh của vùng đệm, được hiển thị bằng màu xanh lục, trong khi bản đồ tiếp tục lấp đầy toàn bộ vùng chứa, được thể hiện bằng màu xanh dương. Trong ví dụ này, bạn có thể làm nổi một trình đơn ở phía bên phải của bản đồ mà không cần che khuất các thành phần điều khiển trên bản đồ.

Khoảng đệm bản đồ

Để thêm khoảng đệm vào bản đồ, hãy tạo một đối tượng UIEdgeInsets và truyền đối tượng đó vào GMSMapView.Thuộc tính padding.

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;

Bảng phối màu bản đồ

Đối với các bản đồ có kiểu thông thường và địa hình, bạn có thể đặt bảng phối màu của bản đồ thành tối, sáng hoặc sử dụng chế độ cài đặt hệ thống hiện tại. Ví dụ: bạn có thể làm tối hoặc làm sáng bảng phối màu của bản đồ dựa trên thời gian trong ngày hoặc việc sử dụng thiết bị trong nhà/ngoài trời.

Dùng GMSMapView overrideUserInterfaceStyle: để đặt và cập nhật bảng phối màu của bản đồ.

Swift

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;