Mảnh bản đồ

lớp công khai MapFragment mở rộng Mảnh

Thành phần Bản đồ trong một ứng dụng. Mảnh này là cách đơn giản nhất để đặt bản đồ trong một ứng dụng. Đó là một trình bao bọc xung quanh chế độ xem bản đồ để tự động xử lý các nhu cầu cần thiết trong vòng đời. Là một mảnh, bạn có thể thêm thành phần này vào tệp bố cục của một hoạt động chỉ bằng XML bên dưới.

 <fragment
    class="com.google.android.libraries.maps.MapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>
Bạn phải mua GoogleMap bằng getMapAsync(OnMapReadyCallback). Lớp này tự động khởi chạy hệ thống bản đồ và chế độ xem.

Một thành phần hiển thị có thể bị xoá khi phương thức onDestroyView() của MapFragment được gọi và Đã đặt lựa chọn useViewLifecycleInFragment(boolean). Khi điều này xảy ra, MapFragment không còn hợp lệ cho đến khi chế độ xem được tạo lại sau này khi Phương thức onCreateView(LayoutInflater, ViewGroup, Bundle) được gọi.

Mọi đối tượng nhận được qua GoogleMap đều được liên kết với thành phần hiển thị này. Quan trọng là không được bám vào đối tượng (ví dụ: Marker) vượt quá vòng đời của khung hiển thị. Nếu không, việc này sẽ gây rò rỉ bộ nhớ vì không thể giải phóng khung hiển thị.

Chỉ sử dụng lớp này nếu bạn đang nhắm đến API 12 trở lên. Nếu không, hãy sử dụng SupportMapFragment bằng cách thêm thư viện hỗ trợ Android vào đường dẫn bản dựng của bạn.

Hướng dẫn cho nhà phát triển

Để biết thêm thông tin, hãy đọc SDK Google Maps dành cho Android hướng dẫn cho nhà phát triển.

Tóm tắt hằng số kế thừa

Tóm tắt hàm khởi tạo công khai

MapFragment()
Tạo một mảnh bản đồ.

Tóm tắt về phương thức công khai

void
getMapAsync(OnMapReadyCallback callback)
Đặt một đối tượng gọi lại sẽ được kích hoạt khi thực thể GoogleMap sẵn sàng để sử dụng.
tĩnh MapFragment
newInstance(các tuỳ chọn GoogleMapOptions)
Tạo một mảnh bản đồ với các tuỳ chọn cho sẵn.
tĩnh MapFragment
newInstance()
Tạo một mảnh bản đồ bằng các tuỳ chọn mặc định.
void
onActivityCreated(Gói savedInstanceState)
void
onAttach(Hoạt động hoạt động)
void
onConfigurationChanged(Cấu hình cấu hình)
void
onCreate(Gói savedInstanceState)
Xem
onCreateView(trình tăng cường LayoutInflater, vùng chứa ViewGroup, gói savedInstanceState)
void
void
cuối cùng trống
onEnterAmbient(Nhóm môi trường xung quanh)
Bạn phải gọi phương thức này từ phương thức tương ứng của WearableActivity.
cuối cùng trống
onExitAmbient()
Bạn phải gọi phương thức này từ phương thức tương ứng của WearableActivity.
void
onInflate(Hoạt động, thuộc tính AttributesSet, SaveInstanceState của gói)
Phân tích cú pháp các thuộc tính trong quá trình tăng cường từ một hệ phân cấp khung hiển thị thành các đối số mà chúng ta xử lý.
void
void
void
void
onSaveInstanceState(Gói outState)
Cung cấp một Bundle để lưu trữ trạng thái của Mảnh trước khi Mảnh bị huỷ.
void
void
Hàm onStop()
void
setArguments(Đối số gói)

Tóm tắt về phương thức kế thừa

Công ty xây dựng công cộng

công khai MapFragment ()

Tạo một mảnh bản đồ. Hàm khởi tạo này chỉ công khai để bộ tăng cường sử dụng. Sử dụng newInstance() để tạo MapFragment theo phương thức lập trình.

Phương thức công khai

công khai trống getMapAsync (Lệnh gọi lại OnMapReadyCallback)

Đặt một đối tượng gọi lại sẽ được kích hoạt khi thực thể GoogleMap sẵn sàng để sử dụng.

Lưu ý:

  • Phương thức này phải được gọi từ luồng chính.
  • Lệnh gọi lại sẽ được thực thi trong luồng chính.
  • Trong trường hợp người dùng không cài đặt Dịch vụ Google Play trên thiết bị, lệnh gọi lại sẽ không được kích hoạt cho đến khi người dùng cài đặt.
  • Trong trường hợp hiếm hoi là GoogleMap bị huỷ ngay sau khi được tạo, không kích hoạt lệnh gọi lại.
  • Đối tượng GoogleMap do lệnh gọi lại cung cấp không rỗng.

Tham số
số gọi lại Đối tượng gọi lại này sẽ được kích hoạt khi bản đồ đã sẵn sàng để sử dụng.

công khai tĩnh MapFragment newInstance (Tuỳ chọn GoogleMapOptions)

Tạo một mảnh bản đồ với các tuỳ chọn cho sẵn.

Tham số
tùy chọn

công khai tĩnh MapFragment newInstance ()

Tạo một mảnh bản đồ bằng các tuỳ chọn mặc định.

công khai trống onActivityCreated (Gói savedInstanceState)

Tham số
savedInstanceState

công khai trống onAttach (Hoạt động)

Tham số
hoạt động

công khai trống onConfigurationChanged (Cấu hình cấu hình)

Tham số
cấu hình

công khai trống onCreate (Gói savedInstanceState)

Tham số
savedInstanceState

công khai Khung hiển thị onCreateView (Bộ tăng cường bố cục inflater, vùng chứa ViewGroup, gói savedInstanceState)

Tham số
dụng cụ bơm
vùng chứa
savedInstanceState

công khai trống onDestroy ()

công khai trống onDestroyView ()

công khai cuối cùng trống onEnterAmbient (Nhóm xung quanhDetails)

Bạn phải gọi phương thức này từ phương thức tương ứng của WearableActivity.

Tham số
ambientDetails

công khai cuối cùng trống onExitAmbient ()

Bạn phải gọi phương thức này từ phương thức tương ứng của WearableActivity.

công khai trống onInflate (Hoạt động hoạt động, thuộc tính AttributesSet, gói savedInstanceState)

Phân tích cú pháp các thuộc tính trong quá trình tăng cường từ một hệ phân cấp khung hiển thị thành các đối số mà chúng ta xử lý.

Tham số
hoạt động
attrs
savedInstanceState

công khai trống onLowMemory ()

công khai trống onPause ()

công khai trống onResume ()

công khai trống onSaveInstanceState (Nhóm bên ngoài trạng thái)

Cung cấp một Bundle để lưu trữ trạng thái của Mảnh trước khi Mảnh bị huỷ. Chiến dịch này có thể sau đó sẽ được truy xuất khi onCreate(Bundle) được gọi lại.

Tham số
outState

công khai trống onStart ()

công khai trống onStop ()

công khai trống setArguments (Đối số gói)

Tham số
args