Sử dụng mã bản đồ
Mã bản đồ là giá trị nhận dạng được liên kết với một kiểu hoặc tính năng bản đồ cụ thể. Định cấu hình kiểu bản đồ và liên kết kiểu đó với mã bản đồ trong Google Cloud Console. Sau đó, khi bạn tham chiếu mã nhận dạng bản đồ trong mã, kiểu bản đồ liên kết với mã nhận dạng đó sẽ xuất hiện trong ứng dụng. Mọi nội dung cập nhật kiểu tiếp theo mà bạn thực hiện sẽ tự động xuất hiện trong ứng dụng mà không cần khách hàng cập nhật.
Khi tạo, mã bản đồ được liên kết với một dự án và cũng bị giới hạn trong một nền tảng duy nhất (Android, iOS, JavaScript) hoặc API tĩnh của Maps.
Để tạo hoặc quản lý mã bản đồ trong Cloud Console, bạn phải có vai trò Chủ sở hữu dự án hoặc Người chỉnh sửa dự án IAM.
Các quyền bắt buộc
Để tạo hoặc quản lý bất kỳ mã bản đồ hay Kiểu bản đồ nào trong một dự án Google Cloud nhất định, bạn phải có vai trò IAM của Chủ sở hữu hoặc Người chỉnh sửa đối với dự án.
Tạo mã bản đồ
Mã bản đồ là giá trị nhận dạng duy nhất đại diện cho một bản sao của Google Maps. Bạn có thể tạo mã bản đồ và cập nhật kiểu liên kết với mã bản đồ bất cứ lúc nào trong Cloud Console.
Cách tạo mã bản đồ:
- Trong Cloud Console, hãy chuyển đến trang Quản lý Maps.
- Chọn Create New Map ID (Tạo mã bản đồ mới) để hiển thị biểu mẫu Create New Map ID (Tạo mã bản đồ mới).
Trong biểu mẫu, hãy làm như sau:
- Chỉ định tên bản đồ.
- Chỉ định loại bản đồ hoặc nền tảng.
- Đối với bản đồ JavaScript, hãy chọn loại bản đồ vectơ hoặc đường quét.
- Nhập mô tả của bản đồ.
- Chọn Tiếp theo để hiển thị mã bản đồ mới.
Liên kết mã bản đồ với kiểu bản đồ
Hướng dẫn này giả định rằng dự án của bạn có ít nhất một kiểu bản đồ hiện có.
- Trong Cloud Console, hãy chuyển đến trang Quản lý Maps.
- Trên trang này, hãy chọn một mã bản đồ hiện có trong cột Tên bản đồ.
- Ở cuối biểu mẫu này, hãy chọn kiểu bản đồ trong trình đơn thả xuống Kiểu bản đồ được liên kết với Mã bản đồ này.
- Chọn Lưu.
Thêm mã bản đồ vào ứng dụng
Android
Thêm mã nhận dạng bản đồ thông qua phần tử <fragment> trong tệp bố cục của hoạt động, bằng cách sử dụng lớp MapView hoặc theo phương thức lập trình bằng lớp GoogleMapOptions.
Ví dụ: giả sử bạn đã tạo một mã bản đồ được lưu trữ dưới dạng giá trị chuỗi có tên map_id trong res/values/strings.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>
Đối với bản đồ được thêm thông qua phần tử <fragment> trong tệp bố cục của hoạt động, tất cả các mảnh bản đồ phải có kiểu tuỳ chỉnh phải chỉ định mã bản đồ trong thuộc tính map:mapId:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
class="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
Bạn cũng có thể sử dụng thuộc tính map:mapId của lớp MapView để chỉ định mã bản đồ:
<com.google.android.gms.maps.MapView
xmlns:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
Để chỉ định mã nhận dạng bản đồ theo phương thức lập trình, hãy truyền mã nhận dạng đó đến một thực thể MapFragment bằng cách sử dụng lớp GoogleMapOptions:
Java
MapFragment mapFragment = MapFragment.newInstance(
new GoogleMapOptions()
.mapId(getResources().getString(R.string.map_id)));
Kotlin
val mapFragment = MapFragment.newInstance(
GoogleMapOptions()
.mapId(resources.getString(R.string.map_id))
)
Trong Android Studio, hãy tạo và chạy ứng dụng như bình thường. Các kiểu tuỳ chỉnh, như được định cấu hình ở bước đầu tiên, sẽ được áp dụng cho tất cả bản đồ có mã nhận dạng.
iOS
Để tạo bản sao của một bản đồ bằng mã bản đồ, hãy làm như sau:
- Tạo
GMSMapIDbằng chuỗi mã bản đồ từ Cloud Console. - Tạo một
GMSMapViewchỉ định mã bản đồ mà bạn vừa tạo.
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "<YOUR MAP ID>")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
longitude:-122.336471
zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"<YOUR MAP ID>"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
Nếu đang sử dụng mã bản đồ của riêng mình, bạn có thể đặt mã bản đồ trong Cloud Console để có kiểu mới bất cứ lúc nào. Kiểu đó sẽ tự động được phản ánh trên chế độ xem bản đồ cho bạn và người dùng trong vòng khoảng 6 giờ.
Nếu muốn xem các thay đổi ngay lập tức, bạn có thể đóng và khởi động lại ứng dụng bằng cách thoát ứng dụng, buộc thoát ứng dụng khỏi danh sách ứng dụng đã sử dụng gần đây, sau đó mở lại ứng dụng. Sau đó, bản đồ đã cập nhật sẽ xuất hiện.
JavaScript
Cách tạo bản đồ có mã bản đồ trong mã xử lý ứng dụng:
Nếu bạn đang tuỳ chỉnh bản đồ bằng mã JSON được nhúng, hãy xoá thuộc tính
styleskhỏi đối tượngMapOptions; nếu không, hãy bỏ qua bước này.Thêm mã bản đồ vào bản đồ bằng thuộc tính
mapId. Ví dụ:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Bản đồ tĩnh
Để thêm mã bản đồ vào một bản đồ mới hoặc hiện có sử dụng một trong các API dịch vụ web của chúng tôi, hãy thêm tham số URL map_id và đặt tham số đó thành mã bản đồ của bạn.
Ví dụ này cho thấy cách thêm mã bản đồ vào bản đồ bằng Maps Static API.
<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />
Các tính năng có sẵn khi sử dụng mã bản đồ
định kiểu bản đồ dựa trên đám mây: tạo kiểu, tùy chỉnh và quản lý bản đồ của bạn bằng Google Cloud Console.
Có trên tất cả nền tảng (Android, JavaScript, iOS và API tĩnh của Maps)
Bản đồ vectơ: một bản đồ bao gồm các ô dựa trên vectơ, được vẽ vào thời điểm tải trên máy khách bằng cách sử dụng WebGL.
Có trên JavaScript