Bản đồ của Google

Bản đồ vệ tinh với một lớp trong suốt của các đường phố chính.

Không có ô bản đồ cơ sở nào.

Bản đồ cơ bản.

Bản đồ vệ tinh không có nhãn.

Bản đồ địa hình.

Thêm một vòng tròn vào bản đồ này.

Thêm hình ảnh vào bản đồ này.

Thêm một điểm đánh dấu vào bản đồ này.

Biểu tượng của điểm đánh dấu được hiển thị trên bản đồ tại vị trí Marker.position. Thao tác nhấp vào điểm đánh dấu sẽ căn giữa máy ảnh trên điểm đánh dấu. Nếu xác định Marker.title, bản đồ sẽ hiển thị một hộp thông tin có tiêu đề và đoạn trích của điểm đánh dấu. Nếu điểm đánh dấu có thể kéo, hãy nhấp và giữ, sau đó kéo điểm đánh dấu sẽ di chuyển điểm đánh dấu đó.

Thêm một đa giác vào bản đồ này.

Thêm một hình nhiều đường vào bản đồ này.

Thêm lớp phủ ô vào bản đồ này. Vui lòng xem TileOverlay để biết thêm thông tin.

Lưu ý không giống như các lớp phủ khác, nếu bản đồ được tạo lại, thì các lớp phủ ô sẽ không được tự động khôi phục và phải được thêm lại theo cách thủ công.

Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật. Trong quá trình tạo ảnh động, lệnh gọi đến getCameraPosition() sẽ trả về một vị trí trung gian của máy ảnh.

Hãy xem CameraUpdateFactory để biết các nội dung cập nhật.

Tạo ảnh động cho chuyển động của máy ảnh từ vị trí hiện tại sang vị trí được xác định trong bản cập nhật và gọi một lệnh gọi lại không bắt buộc khi hoàn tất. Hãy xem CameraUpdateFactory để nắm được các nội dung cập nhật.

Trong quá trình tạo ảnh động, lệnh gọi đến getCameraPosition() sẽ trả về một vị trí trung gian của máy ảnh.

Di chuyển bản đồ theo nội dung cập nhật bằng ảnh động trong một khoảng thời gian cụ thể và gọi một lệnh gọi lại không bắt buộc khi hoàn tất. Hãy xem CameraUpdateFactory để biết các nội dung cập nhật.

Nếu getCameraPosition() được gọi trong quá trình tạo ảnh động, thì giá trị này sẽ trả về vị trí hiện tại của máy ảnh đang bay.

Xóa tất cả các điểm đánh dấu, hình nhiều đường, đa giác, lớp phủ, v.v. khỏi bản đồ.

Lấy vị trí hiện tại của máy ảnh.

CameraPosition được trả về là ảnh chụp nhanh của vị trí hiện tại và sẽ không tự động cập nhật khi máy ảnh di chuyển.

Để biết thêm thông tin về cách thay đổi vị trí của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Lấy toà nhà hiện được đặt tiêu điểm.

Lấy loại bản đồ đang được hiển thị. Hãy xem MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN để biết các giá trị có thể có.

Trả về mức thu phóng tối đa cho vị trí hiện tại của máy ảnh. Điều này xem xét loại bản đồ đang được sử dụng, 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 ô bản đồ cơ sở.

Để biết thêm thông tin về cách thay đổi mức thu phóng của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Trả về mức thu phóng tối thiểu. Điều này là giống nhau cho mọi vị trí (không giống như mức thu phóng tối đa) nhưng có thể khác nhau giữa các thiết bị và kích thước bản đồ.

Để biết thêm thông tin về cách thay đổi mức thu phóng của máy ảnh, hãy xem phần Máy ảnh và chế độ xem.

Trả về vị trí đang hiển thị của người dùng, hoặc null nếu không có dữ liệu vị trí.

Trả về đối tượng Projection mà bạn có thể sử dụng để chuyển đổi giữa toạ độ màn hình và toạ độ vĩ độ/kinh độ.

Projection được trả về là ảnh chụp nhanh của phép chiếu hiện tại và sẽ không tự động cập nhật khi máy ảnh di chuyển. Vì thao tác này tốn kém nên bạn chỉ nên chiếu một lần cho mỗi màn hình. Google Maps sử dụng phép chiếu AndroidX để tạo bản đồ của nó từ dữ liệu địa lý và chuyển đổi các điểm trên bản đồ thành toạ độ địa lý.

Lấy chế độ cài đặt giao diện người dùng của bản đồ.

Trả về xem có bật lớp toà nhà 3D hay không.

Xem bản đồ trong nhà có đang bật hay không.

Nhận trạng thái của lớp vị trí của tôi.

Kiểm tra xem bản đồ có đang vẽ dữ liệu giao thông hay không. Việc này tuỳ thuộc vào tình trạng sẵn có của dữ liệu về lưu lượng truy cập.

Đặt lại vị trí camera theo hướng dẫn được xác định trong bản cập nhật. Quá trình di chuyển diễn ra ngay lập tức và getCameraPosition() tiếp theo sẽ phản ánh vị trí mới. Hãy xem CameraUpdateFactory để nắm được các thông tin cập nhật.

Xoá mọi giới hạn thu phóng trên và dưới được chỉ định trước đó.

Bật hoặc tắt lớp Toà nhà 3D.

Đặt contentDescription cho bản đồ.

Tính năng này được dùng để cung cấp nội dung mô tả bằng giọng nói về bản đồ ở chế độ hỗ trợ tiếp cận. Giá trị mặc định là "Google Map"

Đặt có nên bật bản đồ trong nhà hay không. Hiện tại, bản đồ trong nhà chỉ có thể hiển thị trên một bản đồ tại một thời điểm và theo mặc định, đây là bản đồ đầu tiên được thêm vào ứng dụng của bạn. Để bật bản đồ trong nhà trên bản đồ khác, trước tiên, bạn phải tắt bản đồ trong nhà trên bản đồ gốc. Nếu bạn cố gắng bật bản đồ trong nhà khi tính năng này được bật trên một bản đồ khác, thì sẽ không có gì xảy ra và thao tác này sẽ trả về false. Khi trong nhà không được bật cho bản đồ, mọi phương thức liên quan đến chế độ trong nhà sẽ trả về null hoặc false.

Đặt một trình kết xuất đồ hoạ tuỳ chỉnh cho nội dung của cửa sổ thông tin.

Giống như trình nghe sự kiện của bản đồ, trạng thái này không được chuyển đổi tuần tự cùng với bản đồ. Nếu bản đồ được tạo lại (ví dụ: do thay đổi về cấu hình), bạn phải đảm bảo gọi lại phương thức này để duy trì chế độ tuỳ chỉnh.

Chỉ định một LatLngBounds để ràng buộc mục tiêu máy ảnh để khi người dùng cuộn và xoay bản đồ, mục tiêu máy ảnh không di chuyển ra ngoài các giới hạn này.

Đặt thành rỗng để xoá hoàn toàn hộp giới hạn. Các giới hạn mới sẽ thay thế mọi hộp giới hạn đã chỉ định trước đó.

Khi LatLngBounds thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo các giới hạn đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể khiến SDK không thể giữ máy ảnh nhắm mục tiêu hoàn toàn trong giới hạn. Ví dụ: lỗi làm tròn độ chính xác của dấu phẩy động hoặc mức thu phóng rất thấp.

Thay thế nguồn vị trí của lớp vị trí của tôi.

Thiết lập kiểu của bản đồ cơ sở.

Khi sử dụng các lựa chọn kiểu, bạn có thể áp dụng kiểu tuỳ chỉnh cho các đối tượng và thành phần trên bản đồ. Xem MapStyleOptions để biết thông tin chi tiết về định nghĩa kiểu.

Đặt thành rỗng để xoá mọi kiểu tuỳ chỉnh trước đó.

Đặt loại ô bản đồ sẽ được hiển thị. Các giá trị được phép là:

• MAP_TYPE_NORMAL: Bản đồ cơ bản.
• MAP_TYPE_SATELLITE: Hình ảnh vệ tinh.
• MAP_TYPE_HYBRID: Hình ảnh vệ tinh có đường và nhãn.
• MAP_TYPE_TERRAIN: Dữ liệu địa hình.
• MAP_TYPE_NONE: Không có ô bản đồ cơ sở.

Thiết lập giới hạn trên ưu tiên cho mức thu phóng của máy ảnh.

Khi mức thu phóng tối đa thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo mức tối đa đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể ngăn SDK cho phép người dùng thu phóng quá sâu vào bản đồ. Ví dụ: vệ tinh hoặc địa hình có thể có mức thu phóng tối đa thấp hơn ô bản đồ cơ sở.

SDK giải quyết mọi xung đột về giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu thành mức thu phóng cao hơn mức tối đa hiện tại, SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức thu phóng tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thành mức thu phóng thấp hơn mức tối thiểu, SDK sẽ sử dụng giá trị tối đa mới cho cả mức thu phóng tối thiểu và tối đa. Ví dụ: Giả sử mức thu phóng tối thiểu hiện tại là 8 và tối đa là 14. Sau đó, bạn đặt mức thu phóng tối đa thành 6. SDK sử dụng mức thu phóng tối thiểu là 6 và mức thu phóng tối đa là 6.

Thiết lập giới hạn dưới ưu tiên cho mức thu phóng của máy ảnh.

Khi mức thu phóng tối thiểu thay đổi, SDK sẽ điều chỉnh tất cả các bản cập nhật máy ảnh sau này để tuân theo mức tối thiểu đó (nếu có thể). Xin lưu ý rằng có một số yếu tố kỹ thuật cần cân nhắc có thể ngăn SDK cho phép người dùng thu phóng quá thấp.

SDK giải quyết mọi xung đột về giá trị tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối thiểu thành mức thu phóng cao hơn mức tối đa hiện tại, SDK sẽ sử dụng giá trị tối thiểu mới cho cả mức thu phóng tối thiểu và tối đa. Nếu bạn đặt mức thu phóng tối đa thành mức thu phóng thấp hơn mức tối thiểu, SDK sẽ sử dụng giá trị tối đa mới cho cả mức thu phóng tối thiểu và tối đa. Ví dụ: Giả sử mức thu phóng tối thiểu hiện tại là 8 và tối đa là 14. Sau đó, bạn đặt mức thu phóng tối thiểu thành 16. SDK sử dụng mức thu phóng tối thiểu là 16 và mức thu phóng tối đa là 16.

Bật hoặc tắt lớp vị trí của tôi.

Khi được bật và có thông tin vị trí, lớp vị trí của tôi liên tục vẽ chỉ báo về vị trí và góc phương tiện hiện tại của người dùng, đồng thời hiển thị các chế độ điều khiển trên giao diện người dùng cho phép người dùng tương tác với vị trí của họ (ví dụ: bật hoặc tắt tính năng theo dõi của máy ảnh về vị trí và góc phương vị).

Để sử dụng tính năng lớp vị trí của tôi, bạn cần yêu cầu cấp quyền cho ACCESS_COARSE_LOCATION hoặc ACCESS_FINE_LOCATION trừ phi bạn đã đặt nguồn vị trí tuỳ chỉnh.

Nếu bạn đã đặt nguồn vị trí tùy chỉnh thông qua setLocationSource(LocationSource), SDK Google Maps dành cho Android sẽ không kiểm tra xem các quyền ở trên đã được cấp hay chưa. Tuy nhiên, bạn vẫn cần đảm bảo rằng người dùng đã cấp tất cả các quyền cần thiết đối với nguồn vị trí tuỳ chỉnh.

Đặt một lệnh gọi lại được gọi khi máy ảnh thay đổi.

Đặt một lệnh gọi lại được gọi khi chuyển động của camera kết thúc.

Đặt lệnh gọi lại được gọi khi chuyển động của máy ảnh bị một loại ảnh động mới dừng hoặc gián đoạn.

Đặt lệnh gọi lại được gọi nhiều lần khi camera đang chuyển động. Lệnh gọi lại có thể được gọi thường xuyên như một lần trong mỗi khung hình và không phải thực hiện các thao tác tốn kém.

Đặt lệnh gọi lại được gọi khi máy ảnh bắt đầu di chuyển hoặc lý do chuyển động của máy ảnh thay đổi.

Đặt lệnh gọi lại được gọi khi nhấp vào một vòng kết nối.

Đặt lệnh gọi lại được gọi khi nhấp vào lớp mặt đất.

Thiết lập hoặc xoá trình nghe cho sự kiện trong nhà. Bạn chỉ có thể thiết lập một trình nghe. Việc thiết lập trình nghe mới sẽ xoá trình nghe trước đó.

Đặt lệnh gọi lại được gọi khi cửa sổ thông tin về điểm đánh dấu được nhấp vào.

Đặt lệnh gọi lại được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng.

Đặt lệnh gọi lại được gọi khi bạn nhấn và giữ cửa sổ thông tin của điểm đánh dấu.

Đặt một lệnh gọi lại được gọi khi người dùng nhấn vào bản đồ.

Đặt lệnh gọi lại được gọi khi bản đồ này kết xuất xong. Lệnh gọi lại sẽ chỉ được gọi một lần.

Nếu phương thức này được gọi khi bản đồ hiển thị hoàn toàn, thì lệnh gọi lại sẽ được gọi ngay lập tức. Sự kiện này sẽ không kích hoạt nếu bản đồ không bao giờ tải do vấn đề về kết nối, hoặc nếu bản đồ liên tục thay đổi và không bao giờ hoàn tất việc tải do người dùng liên tục tương tác với bản đồ.

Đặt lệnh gọi lại được gọi khi nhấn và giữ bản đồ.

Đặt lệnh gọi lại được gọi khi nhấp vào một điểm đánh dấu.

Đặt lệnh gọi lại được gọi khi bạn kéo một điểm đánh dấu.

Đặt lệnh gọi lại được gọi khi nút vị trí của tôi được nhấp vào.

Nếu listener trả về true, sự kiện sẽ được sử dụng và hành vi mặc định sẽ không xảy ra. Nếu trả về false, hành vi mặc định sẽ diễn ra (tức là máy ảnh di chuyển sao cho nằm giữa vị trí của người dùng).

Đặt lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi thay đổi vị trí.

Đặt lệnh gọi lại được gọi khi dấu chấm Vị trí của tôi (biểu thị vị trí của người dùng) được nhấp vào.

Thiết lập trình nghe sẽ được kích hoạt khi người dùng nhấp hoặc nhấn vào một POI.

Truyền null để xoá trình nghe.

Đặt lệnh gọi lại được gọi khi nhấp vào đa giác.

Đặt lệnh gọi lại được gọi khi nhấp vào một hình nhiều đường.

Đặt khoảng đệm trên bản đồ.

Phương thức này cho phép bạn xác định một khu vực nhìn thấy trên bản đồ, để báo hiệu cho bản đồ rằng các phần của bản đồ xung quanh cạnh có thể bị che khuất bằng cách đặt khoảng đệm ở một trong 4 cạnh của bản đồ. Hàm ánh xạ sẽ được điều chỉnh cho phù hợp với khoảng đệm. Ví dụ: các nút điều khiển thu phóng, la bàn, thông báo bản quyền và biểu trưng của Google sẽ được di chuyển cho vừa với khu vực đã xác định, chuyển động của máy ảnh sẽ tương ứng với trung tâm của khu vực hiển thị, v.v.

Bật hoặc tắt lớp giao thông.

Chụp ảnh nhanh về bản đồ.

Bạn có thể sử dụng ảnh chụp nhanh trong ứng dụng khi bản đồ tương tác gặp khó khăn hoặc không thể sử dụng. Ví dụ: bạn có thể sử dụng hình ảnh tạo bằng phương thức snapshot() để hiển thị hình thu nhỏ của bản đồ trong ứng dụng hoặc ảnh chụp nhanh trong trung tâm thông báo.

Lưu ý: Không được truyền hình ảnh của bản đồ đến máy chủ của bạn hoặc sử dụng hình ảnh bên ngoài ứng dụng. Nếu bạn cần gửi bản đồ cho một ứng dụng hoặc người dùng khác, hãy gửi dữ liệu cho phép họ tạo lại bản đồ cho người dùng mới thay vì ảnh chụp nhanh.

Chụp ảnh nhanh về bản đồ.

Phương thức này tương đương với snapshot(SnapshotReadyCallback) nhưng cho phép bạn cung cấp Bitmap được phân bổ trước. Nếu bitmap không khớp với kích thước hiện tại của bản đồ, thì một bitmap khác sẽ được phân bổ phù hợp với kích thước của bản đồ.

Mặc dù trong hầu hết các trường hợp, đối tượng mà phương thức gọi lại truyền đều giống với đối tượng được cung cấp trong thông số cho phương thức này, nhưng trong một số trường hợp, đối tượng được trả về có thể khác (ví dụ: nếu kích thước của khung hiển thị đã thay đổi trước thời điểm thực sự chụp ảnh chụp nhanh). Do đó, bạn chỉ nên tin tưởng nội dung của bitmap được truyền bằng phương thức gọi lại.

Dừng ảnh động của máy ảnh nếu có một ảnh đang diễn ra. Khi phương thức này được gọi, máy ảnh sẽ ngừng di chuyển ngay lập tức và vẫn ở vị trí đó.