Bạn có thể nghiêng và xoay bản đồ trong SDK Bản đồ dành cho Android bằng các cử chỉ dễ dàng, cho phép người dùng điều chỉnh bản đồ theo hướng phù hợp với họ. Ở mọi mức thu phóng, bạn có thể xoay bản đồ hoặc thay đổi phối cảnh của bản đồ với độ trễ rất thấp nhờ kích thước nhỏ hơn của các ô bản đồ dựa trên vectơ.
Mã mẫu
Kho lưu trữ ApiDemos trên GitHub bao gồm một mẫu minh hoạ các tính năng của máy ảnh:
- CameraDemoActivity – Kotlin: Thay đổi vị trí của máy ảnh
- Camera DemoActivity – Java: Thay đổi vị trí của camera
Giới thiệu
Giống như Google Maps trên web, SDK Maps dành cho Android biểu thị bề mặt thế giới (hình cầu) trên màn hình của thiết bị (mặt phẳng) bằng cách sử dụng phép chiếu Mercator. Theo hướng đông và hướng tây, bản đồ được lặp lại vô hạn khi thế giới tự bao bọc một cách tự nhiên. Ở hướng bắc và nam, bản đồ bị giới hạn ở khoảng 85 độ bắc và 85 độ nam.
Lưu ý: Phép chiếu Mercator có chiều rộng hữu hạn theo chiều dọc nhưng chiều cao vô hạn theo vĩ độ. Chúng tôi "cắt" hình ảnh bản đồ cơ sở bằng cách dùng phép chiếu Mercator ở khoảng +/- 85 độ để làm cho hình dạng bản đồ thu được là hình vuông, giúp chọn ô dễ dàng hơn.
SDK Bản đồ dành cho Android cho phép bạn thay đổi điểm nhìn của người dùng trên bản đồ bằng cách sửa đổi camera của bản đồ.
Những thay đổi đối với máy ảnh sẽ không ảnh hưởng đến các điểm đánh dấu, lớp phủ hoặc đồ hoạ khác mà bạn đã thêm, mặc dù bạn có thể muốn thay đổi nội dung bổ sung để phù hợp hơn với chế độ xem mới.
Vì có thể nghe các cử chỉ của người dùng trên bản đồ, nên bạn có thể thay đổi bản đồ để phản hồi các yêu cầu của người dùng. Ví dụ: phương thức gọi lại OnMapClickListener.onMapClick()
phản hồi một lần nhấn trên bản đồ. Vì phương thức này nhận được vĩ độ và kinh độ của vị trí nhấn, nên bạn có thể phản hồi bằng cách kéo hoặc thu phóng đến điểm đó.
Bạn có thể sử dụng các phương thức tương tự để phản hồi thao tác nhấn vào bong bóng của điểm đánh dấu hoặc để phản hồi cử chỉ kéo trên điểm đánh dấu.
Bạn cũng có thể theo dõi chuyển động của máy ảnh để ứng dụng của bạn nhận được thông báo khi máy ảnh bắt đầu di chuyển, đang di chuyển hoặc dừng di chuyển. Để biết thông tin chi tiết, hãy xem hướng dẫn về sự kiện thay đổi máy ảnh.
Vị trí máy ảnh
Chế độ xem bản đồ được mô hình hoá như một máy ảnh nhìn xuống mặt phẳng. Vị trí của camera (và do đó khả năng hiển thị của bản đồ) được chỉ định bằng các thuộc tính sau: mục tiêu (vĩ độ/kinh độ của địa điểm), mang, nghiêng và thu phóng.
Mục tiêu (vị trí)
Mục tiêu của máy ảnh là vị trí của tâm bản đồ, được chỉ định dưới dạng tọa độ vĩ độ và kinh độ.
Vĩ độ có thể nằm trong khoảng từ -85 đến 85 độ. Các giá trị trên hoặc dưới phạm vi này sẽ được cố định thành giá trị gần nhất trong phạm vi này. Ví dụ: chỉ định vĩ độ là 100 sẽ đặt giá trị thành 85. Kinh độ nằm trong khoảng từ -180 đến 180 độ. Các giá trị cao hơn hoặc thấp hơn phạm vi này sẽ được gói sao cho nằm trong phạm vi (-180, 180). Ví dụ: 480, 840 và 1200 đều sẽ được gói thành 120 độ.Phương vị (hướng)
Độ lệch của máy ảnh chỉ định hướng la bàn, được đo bằng độ từ hướng bắc thực, tương ứng với cạnh trên cùng của bản đồ. Nếu bạn vẽ một đường dọc từ tâm bản đồ đến cạnh trên cùng của bản đồ, góc phương vị tương ứng với tiêu đề của máy ảnh (được đo bằng độ) so với hướng bắc thực.
Góc bằng 0 có nghĩa là đỉnh bản đồ trỏ đến hướng bắc thực sự. Giá trị góc phương vị 90 có nghĩa là đỉnh của bản đồ chỉ về hướng đông (90 độ trên la bàn). Giá trị 180 có nghĩa là đầu bản đồ chỉ về phía nam.
API Maps cho phép bạn thay đổi hướng của bản đồ. Ví dụ: người lái xe ô tô thường xoay bản đồ đường bộ để căn chỉnh theo hướng đi của họ, trong khi người đi bộ đường dài sử dụng bản đồ và la bàn thường định hướng bản đồ để một đường thẳng đứng hướng về phía bắc.
Nghiêng (góc nhìn)
Độ nghiêng xác định vị trí của máy ảnh trên một vòng cung ngay phía trên vị trí trung tâm của bản đồ, được đo bằng độ từ nadir (hướng chỉ thẳng xuống dưới máy ảnh). Giá trị 0 tương ứng với một máy ảnh hướng thẳng xuống. Các giá trị lớn hơn 0 tương ứng với một máy ảnh được hướng về chân trời theo số độ được chỉ định. Khi bạn thay đổi góc nhìn, bản đồ sẽ xuất hiện theo phối cảnh, với các đối tượng ở xa sẽ xuất hiện nhỏ hơn và các đối tượng ở gần sẽ xuất hiện lớn hơn. Các hình minh hoạ sau đây minh hoạ điều này.
Trong các hình ảnh bên dưới, góc nhìn là 0 độ. Hình ảnh đầu tiên cho thấy sơ đồ của điều này; vị trí 1 là vị trí máy ảnh và vị trí 2 là vị trí bản đồ hiện tại. Bản đồ kết quả sẽ hiển thị bên dưới nó.
Trong hình ảnh bên dưới, góc nhìn là 45 độ. Lưu ý rằng máy ảnh di chuyển một nửa dọc theo một vòng cung giữa vị trí thẳng phía trên đầu (0 độ) và mặt đất (90 độ) đến vị trí 3. Máy ảnh vẫn đang hướng vào điểm trung tâm của bản đồ, nhưng khu vực được biểu thị bằng đường kẻ ở vị trí 4 hiện đã hiển thị.
Bản đồ trong ảnh chụp màn hình này vẫn được căn giữa cùng một điểm như trong bản đồ gốc, nhưng nhiều tính năng khác đã xuất hiện ở đầu bản đồ. Khi bạn tăng góc vượt quá 45 độ, các đối tượng giữa máy ảnh và vị trí bản đồ sẽ xuất hiện lớn hơn theo tỷ lệ tương ứng, trong khi các đối tượng nằm ngoài vị trí bản đồ sẽ xuất hiện nhỏ hơn theo tỷ lệ tương ứng, mang lại hiệu ứng ba chiều.
Zoom (thu phóng)
Mức thu phóng của máy ảnh xác định tỷ lệ của bản đồ. Ở mức thu phóng lớn hơn, người dùng có thể thấy nhiều chi tiết hơn trên màn hình, còn ở mức thu phóng nhỏ hơn, người dùng có thể thấy nhiều nội dung hơn trên màn hình. Ở mức thu phóng 0, tỷ lệ của bản đồ là toàn bộ thế giới có chiều rộng khoảng 256 dp (pixel không phụ thuộc vào mật độ).
Việc tăng mức thu phóng lên 1 sẽ tăng gấp đôi chiều rộng của thế giới trên màn hình. Do đó, ở cấp độ thu phóng N, chiều rộng của thế giới là khoảng 256 * 2N dp. Ví dụ: ở mức thu phóng 2, toàn bộ thế giới có chiều rộng xấp xỉ 1024 dp.
Mức thu phóng không cần phải là một số nguyên. Phạm vi mức thu phóng mà bản đồ cho phép phụ thuộc vào một số yếu tố, bao gồm mục tiêu, loại bản đồ và kích thước màn hình. Bất kỳ số nào nằm ngoài phạm vi sẽ được chuyển đổi sang giá trị hợp lệ gần nhất tiếp theo, có thể là mức thu phóng tối thiểu hoặc mức thu phóng tối đa. Danh sách sau đây cho thấy mức độ chi tiết gần đúng mà bạn có thể thấy ở mỗi mức thu phóng:
- 1: Thế giới
- 5: Vùng đất/lục địa
- 10: Thành phố
- 15: Đường phố
- 20: Toà nhà
Di chuyển máy ảnh
API Maps cho phép bạn thay đổi khu vực của thế giới hiển thị trên bản đồ. Điều này được thực hiện bằng cách thay đổi vị trí của máy ảnh (thay vì di chuyển bản đồ).
Khi thay đổi camera, bạn có thể tạo ảnh động cho chuyển động của camera thu được. Ảnh động nội suy giữa các thuộc tính máy ảnh hiện tại và các thuộc tính máy ảnh mới. Bạn cũng có thể kiểm soát thời lượng của ảnh động.
Để thay đổi vị trí của camera, bạn phải chỉ định nơi bạn muốn di chuyển camera bằng cách sử dụng CameraUpdate
. API Maps cho phép bạn tạo nhiều loại CameraUpdate
bằng cách sử dụng CameraUpdateFactory
. Bạn có các tuỳ chọn sau đây:
Thay đổi mức thu phóng và đặt mức thu phóng tối thiểu/tối đa
CameraUpdateFactory.zoomIn()
và CameraUpdateFactory.zoomOut()
cung cấp cho bạn một CameraUpdate
thay đổi mức thu phóng thêm 1.0, trong khi vẫn giữ nguyên tất cả các thuộc tính khác.
CameraUpdateFactory.zoomTo(float)
cung cấp cho bạn một CameraUpdate
thay đổi mức thu phóng thành giá trị đã cho, trong khi vẫn giữ nguyên tất cả các thuộc tính khác.
CameraUpdateFactory.zoomBy(float)
và CameraUpdateFactory.zoomBy(float, Point)
sẽ cung cấp cho bạn một CameraUpdate
giúp tăng (hoặc giảm, nếu giá trị là âm) mức thu phóng theo giá trị đã cho. Sau đó, cố định một điểm nhất định trên màn hình để điểm đó vẫn ở cùng một vị trí (vĩ độ/kinh độ) và có thể thay đổi vị trí của máy ảnh để đạt được điều này.
Bạn có thể thấy hữu ích khi đặt mức thu phóng tối thiểu và/hoặc tối đa ưa thích. Ví dụ: tính năng này giúp kiểm soát trải nghiệm của người dùng nếu ứng dụng của bạn hiển thị một khu vực xác định xung quanh một địa điểm yêu thích, hoặc nếu bạn đang dùng lớp phủ ô tuỳ chỉnh với một nhóm mức thu phóng giới hạn.
Kotlin
private lateinit var map: GoogleMap map.setMinZoomPreference(6.0f) map.setMaxZoomPreference(14.0f)
Java
private GoogleMap map; map.setMinZoomPreference(6.0f); map.setMaxZoomPreference(14.0f);
Xin lưu ý rằng có một số cân nhắc về kỹ thuật có thể ngăn API này cho phép người dùng phóng to quá thấp hoặc quá cao. Ví dụ: vệ tinh hoặc địa hình có thể có mức thu phóng tối đa thấp hơn so với các ô bản đồ cơ sở.
Thay đổi vị trí máy ảnh
Có hai phương pháp thuận tiện cho các thay đổi phổ biến về vị trí.
CameraUpdateFactory.newLatLng(LatLng)
cung cấp cho bạn một CameraUpdate
thay đổi vĩ độ và kinh độ của máy ảnh trong khi vẫn giữ nguyên tất cả thuộc tính khác.
CameraUpdateFactory.newLatLngZoom(LatLng, float)
cung cấp cho bạn CameraUpdate
thay đổi vĩ độ, kinh độ và mức thu phóng của máy ảnh trong khi vẫn giữ nguyên tất cả thuộc tính khác.
Để hoàn toàn linh hoạt trong việc thay đổi vị trí của camera, hãy sử dụng CameraUpdateFactory.newCameraPosition(CameraPosition)
để cung cấp cho bạn CameraUpdate
di chuyển camera đến vị trí nhất định. Bạn có thể lấy CameraPosition
trực tiếp bằng cách sử dụng new CameraPosition()
hoặc CameraPosition.Builder
bằng new CameraPosition.Builder()
.
Kéo (cuộn)
CameraUpdateFactory.scrollBy(float, float)
cung cấp cho bạn một CameraUpdate
thay đổi vĩ độ và kinh độ của máy ảnh để bản đồ di chuyển theo số lượng pixel đã chỉ định. Giá trị x dương làm cho máy ảnh di chuyển sang phải, do đó bản đồ dường như đã di chuyển sang trái. Giá trị y dương làm cho máy ảnh di chuyển xuống, do đó bản đồ dường như đã di chuyển lên trên. Ngược lại, các giá trị x âm khiến máy ảnh di chuyển sang trái, vì vậy, bản đồ có vẻ như đã di chuyển sang phải và các giá trị y âm khiến máy ảnh di chuyển lên trên. Thao tác cuộn tương ứng với hướng hiện tại của máy ảnh. Ví dụ: nếu máy ảnh có góc 90 độ, thì hướng đông là "lên".
Đặt ra ranh giới
Đặt ranh giới của bản đồ
Đôi khi, bạn nên di chuyển máy ảnh sao cho toàn bộ khu vực quan tâm có thể nhìn thấy được ở mức thu phóng lớn nhất có thể. Ví dụ: nếu bạn đang hiển thị tất cả các trạm xăng trong phạm vi 8 km từ vị trí hiện tại của người dùng, thì bạn nên di chuyển máy ảnh để tất cả các trạm xăng đều hiển thị trên màn hình. Để làm việc này, trước tiên, hãy tính toán LatLngBounds
mà bạn muốn hiển thị trên màn hình. Sau đó, bạn có thể sử dụng CameraUpdateFactory.newLatLngBounds(LatLngBounds bounds, int
padding)
để lấy CameraUpdate
có thể thay đổi vị trí máy ảnh sao cho LatLngBounds
nhất định vừa vặn hoàn toàn bên trong bản đồ, có tính đến khoảng đệm (tính bằng pixel) được chỉ định. CameraUpdate
được trả về đảm bảo rằng khoảng cách (tính bằng pixel) giữa các giới hạn đã cho và cạnh của bản đồ sẽ ít nhất bằng khoảng đệm được chỉ định. Xin lưu ý rằng độ nghiêng và góc phương vị của bản đồ đều sẽ là 0.
Kotlin
val australiaBounds = LatLngBounds( LatLng((-44.0), 113.0), // SW bounds LatLng((-10.0), 154.0) // NE bounds ) map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0))
Java
LatLngBounds australiaBounds = new LatLngBounds( new LatLng(-44, 113), // SW bounds new LatLng(-10, 154) // NE bounds ); map.moveCamera(CameraUpdateFactory.newLatLngBounds(australiaBounds, 0));
Đặt bản đồ ở giữa một khu vực
Trong một số trường hợp, bạn có thể muốn đặt máy ảnh ở giữa một giới hạn thay vì bao gồm cả các đường viền cực đoan. Ví dụ: để căn giữa máy ảnh vào một quốc gia trong khi vẫn duy trì mức thu phóng không đổi. Trong trường hợp này, bạn có thể sử dụng phương thức tương tự bằng cách tạo LatLngBounds
và sử dụng CameraUpdateFactory.newLatLngZoom(LatLng latLng, float zoom)
với LatLngBounds
.getCenter()
. Phương thức getCenter() sẽ trả về tâm địa lý của LatLngBounds
.
Kotlin
val australiaBounds = LatLngBounds( LatLng((-44.0), 113.0), // SW bounds LatLng((-10.0), 154.0) // NE bounds ) map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.center, 10f))
Java
LatLngBounds australiaBounds = new LatLngBounds( new LatLng(-44, 113), // SW bounds new LatLng(-10, 154) // NE bounds ); map.moveCamera(CameraUpdateFactory.newLatLngZoom(australiaBounds.getCenter(), 10));
Phương thức nạp chồng newLatLngBounds(boundary, width, height,
padding)
cho phép bạn chỉ định chiều rộng và chiều cao tính bằng pixel cho một hình chữ nhật, với ý định là các kích thước này tương ứng với kích thước của bản đồ. Hình chữ nhật này được đặt sao cho tâm giống với tâm điểm của bản đồ (để nếu kích thước được chỉ định giống với kích thước của chế độ xem bản đồ, thì hình chữ nhật đó sẽ khớp với chế độ xem của bản đồ). CameraUpdate
được trả về sẽ di chuyển máy ảnh sao cho LatLngBounds
được chỉ định nằm ở giữa màn hình trong hình chữ nhật đã cho ở mức thu phóng lớn nhất có thể, có tính đến khoảng đệm bắt buộc.
Lưu ý: Chỉ sử dụng phương thức đơn giản hơn newLatLngBounds(boundary, padding)
để tạo CameraUpdate
nếu phương thức này sẽ được dùng để di chuyển camera sau khi bản đồ đã hoàn tất bố cục. Trong khi bố cục, API sẽ tính toán các ranh giới hiển thị của bản đồ cần thiết để chiếu hộp giới hạn một cách chính xác. Để so sánh, bạn có thể sử dụng CameraUpdate
được trả về bằng phương thức newLatLngBounds(boundary, width, height, padding)
phức tạp hơn bất kỳ lúc nào, ngay cả trước khi bản đồ có bố cục, vì API tính toán ranh giới hiển thị từ các đối số mà bạn truyền.
Hạn chế thao tác kéo của người dùng ở một khu vực nhất định
Trong các trường hợp trên, bạn đặt giới hạn của bản đồ nhưng người dùng có thể cuộn hoặc kéo ra ngoài các giới hạn này. Thay vào đó, bạn nên ràng buộc các ranh giới giữa vĩ độ/kinh độ của tiêu điểm bản đồ (mục tiêu máy ảnh) để người dùng chỉ có thể cuộn và lia trong các giới hạn này. Ví dụ: một ứng dụng bán lẻ cho trung tâm mua sắm hoặc sân bay có thể muốn ràng buộc bản đồ trong một giới hạn cụ thể, cho phép người dùng cuộn và kéo trong những giới hạn đó.
Kotlin
// Create a LatLngBounds that includes the city of Adelaide in Australia. val adelaideBounds = LatLngBounds( LatLng(-35.0, 138.58), // SW bounds LatLng(-34.9, 138.61) // NE bounds ) // Constrain the camera target to the Adelaide bounds. map.setLatLngBoundsForCameraTarget(adelaideBounds)
Java
// Create a LatLngBounds that includes the city of Adelaide in Australia. LatLngBounds adelaideBounds = new LatLngBounds( new LatLng(-35.0, 138.58), // SW bounds new LatLng(-34.9, 138.61) // NE bounds ); // Constrain the camera target to the Adelaide bounds. map.setLatLngBoundsForCameraTarget(adelaideBounds);
Sơ đồ sau đây minh hoạ một tình huống khi mục tiêu của máy ảnh bị ràng buộc trong một khu vực lớn hơn một chút so với khung nhìn. Người dùng có thể cuộn và xoay, miễn là mục tiêu máy ảnh vẫn nằm trong vùng giới hạn. Dấu thập đại diện cho mục tiêu của máy ảnh:
Bản đồ luôn lấp đầy khung nhìn, ngay cả khi điều đó khiến khung nhìn hiển thị các khu vực nằm ngoài giới hạn đã xác định. Ví dụ: nếu bạn đặt mục tiêu máy ảnh ở một góc của khu vực bị giới hạn, thì khu vực nằm ngoài góc sẽ hiển thị trong khung nhìn nhưng người dùng không thể cuộn thêm vào khu vực đó. Sơ đồ sau đây minh hoạ trường hợp này. Chữ thập đại diện cho mục tiêu của máy ảnh:
Trong sơ đồ sau, mục tiêu của máy ảnh có giới hạn rất hạn chế, khiến người dùng có rất ít cơ hội cuộn hoặc xoay bản đồ. Dấu thập đại diện cho mục tiêu của máy ảnh:
Cập nhật chế độ xem máy ảnh
Để áp dụng CameraUpdate
cho bản đồ, bạn có thể di chuyển máy ảnh ngay lập tức hoặc tạo ảnh động cho máy ảnh một cách mượt mà. Để di chuyển camera ngay lập tức bằng CameraUpdate
nhất định, bạn có thể gọi GoogleMap.moveCamera(CameraUpdate)
.
Bạn có thể làm cho trải nghiệm người dùng trở nên dễ chịu hơn, đặc biệt là đối với các động tác ngắn, bằng cách tạo ảnh động cho sự thay đổi đó. Để thực hiện việc này, thay vì gọi GoogleMap.moveCamera
, hãy gọi GoogleMap.animateCamera
.
Bản đồ sẽ di chuyển liền mạch đến các thuộc tính mới. Dạng chi tiết nhất của phương thức này, GoogleMap.animateCamera(cameraUpdate, duration, callback)
, cung cấp 3 đối số:
cameraUpdate
CameraUpdate
mô tả vị trí di chuyển camera.callback
- Đối tượng triển khai
GoogleMap.CancellableCallback
. Giao diện tổng quát này để xử lý các tác vụ xác định hai phương thức là `onCancel()` và `onFinished()`. Đối với ảnh động, các phương thức này được gọi trong các trường hợp sau:onFinish()
- Được gọi nếu ảnh động hoàn tất mà không bị gián đoạn.
onCancel()
-
Được gọi nếu ảnh động bị gián đoạn bằng cách gọi
stopAnimation()
hoặc bắt đầu một chuyển động máy ảnh mới.Ngoài ra, điều này cũng có thể xảy ra nếu bạn gọi
GoogleMap.stopAnimation()
.
duration
- Thời lượng mong muốn của ảnh động, tính bằng mili giây, dưới dạng
int
.
Các đoạn mã sau đây minh hoạ một số cách phổ biến để di chuyển camera.
Kotlin
val sydney = LatLng(-33.88, 151.21) val mountainView = LatLng(37.4, -122.1) // Move the camera instantly to Sydney with a zoom of 15. map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15f)) // Zoom in, animating the camera. map.animateCamera(CameraUpdateFactory.zoomIn()) // Zoom out to zoom level 10, animating with a duration of 2 seconds. map.animateCamera(CameraUpdateFactory.zoomTo(10f), 2000, null) // Construct a CameraPosition focusing on Mountain View and animate the camera to that position. val cameraPosition = CameraPosition.Builder() .target(mountainView) // Sets the center of the map to Mountain View .zoom(17f) // Sets the zoom .bearing(90f) // Sets the orientation of the camera to east .tilt(30f) // Sets the tilt of the camera to 30 degrees .build() // Creates a CameraPosition from the builder map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))
Java
LatLng sydney = new LatLng(-33.88,151.21); LatLng mountainView = new LatLng(37.4, -122.1); // Move the camera instantly to Sydney with a zoom of 15. map.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 15)); // Zoom in, animating the camera. map.animateCamera(CameraUpdateFactory.zoomIn()); // Zoom out to zoom level 10, animating with a duration of 2 seconds. map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null); // Construct a CameraPosition focusing on Mountain View and animate the camera to that position. CameraPosition cameraPosition = new CameraPosition.Builder() .target(mountainView ) // Sets the center of the map to Mountain View .zoom(17) // Sets the zoom .bearing(90) // Sets the orientation of the camera to east .tilt(30) // Sets the tilt of the camera to 30 degrees .build(); // Creates a CameraPosition from the builder map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));