Mảnh bản đồ

lớp công khai MapFragment mở rộng Fragment

Thành phần Bản đồ trong ứng dụng. Mảnh này là cách đơn giản nhất để đặt bản đồ vào ứng dụng. Đó là một trình bao bọc 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, thành phần này có thể được thêm 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 lấy GoogleMap bằng cách sử dụng getMapAsync(OnMapReadyCallback). Lớp này sẽ tự động khởi chạy hệ thống bản đồ và thành phần hiển thị.

Bạn có thể xoá một thành phần hiển thị khi phương thức onDestroyView() của MapFragment&hl=vi được gọi và tuỳ chọn useViewLifecycleInFragment(boolean) đã được đặt. 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 đó khi phương thức onCreateView(LayoutInflater, ViewGroup, Bundle) của MapFragment&hl=vi được gọi.

Mọi đối tượng thu được từ GoogleMap đều được liên kết với thành phần hiển thị này. Bạn không nên giữ lại các đối tượng (ví dụ: Marker) ngoài phạm vi cuộc sống của chế độ xem. Nếu không, hàm này sẽ bị rò rỉ bộ nhớ vì không thể huỷ chế độ xem.

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 hướng dẫn dành cho nhà phát triển SDK Google Maps dành cho Android.

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

Bản tóm tắt về hàm dựng công khai

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

Tóm tắt phương pháp công khai

void
getMapAsync(lệnh gọi lại OnMapReadyCallback)
Đặt đối tượng gọi lại sẽ được kích hoạt khi thực thể GoogleMap đã sẵn sàng được sử dụng.
MapFragment tĩnh
newInstance(các tuỳ chọn GoogleMapOptions)
Tạo một mảnh bản đồ với các tuỳ chọn đã cho.
MapFragment tĩnh
newInstance()
Tạo một mảnh bản đồ bằng cách sử dụ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(LayoutInflater thổi phồng, Vùng chứa ViewGroup, Gói thực thể đã lưu)
void
void
khoảng trống cuối cùng
onEnterAmbient(Gói 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.
khoảng trống cuối cù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 hoạt động, Thuộc tính thuộc tính đã đặt, Gói thực thể đã lưu)
Phân tích cú pháp các thuộc tính trong khi tăng cường từ một hệ phân cấp chế độ xem vào các đối số mà chúng ta xử lý.
void
void
void
void
onSaveInstanceState(Gói đầu ra)
Cung cấp Bundle để lưu trữ trạng thái của Mảnh trước khi bị huỷ.
void
void
onStop()
void
setArguments (Gói đối số)

Tóm tắt phương pháp kế thừa

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 để tăng cường. Sử dụng newInstance() để tạo MapFragment theo phương thức lập trình.

Phương thức công khai

public void getMapAsync (OnMapReadyCallback gọi)

Đặt đối tượng gọi lại sẽ được kích hoạt khi thực thể GoogleMap đã sẵn sàng được 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 Dịch vụ Google Play không được cài đặt trên thiết bị của người dùng, 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 gặp khi GoogleMap bị hủy ngay sau khi tạo, lệnh gọi lại sẽ không được kích hoạt.
  • Đối tượng GoogleMap do lệnh gọi lại cung cấp không có giá trị rỗng.

Các tham số
cuộc gọi lại Đối tượng gọi lại sẽ được kích hoạt khi bản đồ sẵn sàng để được sử dụng.

công khai MapFragment newInstance (Tùy chọn GoogleMapOptions)

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

Các tham số
tùy chọn

công khai MapFragment newInstance ()

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

public void onActivityCreated (Gói savedInstanceState)

Các tham số
savedInstanceState

public void onAttach (Hoạt động hoạt động)

Các tham số
hoạt động

public void onConfigurationChanged (Cấu hình cấu hình)

Các tham số
cấu hình

public void onCreate (Gói savedinstanceState)

Các tham số
savedInstanceState

public Chế độ xem onCreateView (LayoutInflaterflater, vùng chứa ViewGroup, Gói savedInstanceState)

Các tham số
thổi phồng
vùng chứa
savedInstanceState

public void onDestroy ()

public void onDestroyView ()

public public void onEnterAmbient (Gói 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.

Các tham số
Chi tiết môi trường xung quanh

public public void onExitAmbient ()

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

public void onInflate (Activity activity, AttributesSet attrs, Bundle savedInstanceState)

Phân tích cú pháp các thuộc tính trong khi tăng cường từ một hệ phân cấp chế độ xem vào các đối số mà chúng ta xử lý.

Các tham số
hoạt động
thuộc tính
savedInstanceState

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Gói đầu ra)

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

Các tham số
trạng thái đầu ra

public void onBắt đầu ()

public void onStop ()

public void setArguments (Gói đối số)

Các tham số
args