Um componente de mapa em um app. Esse fragmento é a maneira mais simples de colocar um mapa em um app. É um wrapper em torno de uma visualização de mapa para lidar automaticamente com as necessidades necessárias do ciclo de vida. Por ser um fragmento, esse componente pode ser adicionado ao arquivo de layout de uma atividade simplesmente com o XML abaixo.
<fragment class="com.google.android.libraries.maps.SupportMapFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>É preciso adquirir um
GoogleMap
usando getMapAsync(OnMapReadyCallback)
. Essa classe inicializa automaticamente o sistema de mapas e a visualização.
Uma visualização pode ser removida quando o método onDestroyView()
do SupportMapFragment é chamado e a opção useViewLifecycleInFragment(boolean)
é definida. Quando isso acontece, o SupportMapFragment não é mais válido até que a visualização seja recriada novamente mais tarde, quando o método onCreateView(LayoutInflater, ViewGroup, Bundle)
do SupportMapFragment for chamado.
Todos os objetos recebidos do GoogleMap
são associados à visualização. É importante
não reter objetos (por exemplo, Marker
) além do
período de vida da visualização. Caso contrário, isso vai causar um vazamento de memória, já que a visualização não pode ser liberada.
Para usar essa classe, é necessário incluir a Biblioteca de Suporte do Android no seu caminho de compilação.
Guia do desenvolvedor
Para ver mais informações, leia o guia para desenvolvedores do SDK do Google Maps para Android .
Resumo do construtor público
SupportMapFragment()
Cria um fragmento de mapa.
|
Resumo do método público
void |
getMapAsync(OnMapReadyCallback callback)
Define um objeto de callback que será acionado quando a instância
GoogleMap estiver pronta para
ser usada. |
estático SupportMapFragment | |
estático SupportMapFragment |
newInstance()
Cria um fragmento de mapa usando as opções padrão.
|
void |
onActivityCreated(pacote savedInstanceState)
|
void |
onAttach(atividade da atividade)
|
void |
onConfigurationChanged(configuração)
|
void |
onCreate(pacote savedInstanceState)
|
View |
onCreateView(inflador de LayoutInflater, contêiner ViewGroup, pacote savedInstanceState)
|
void | |
void | |
nulo final |
onEnterAmbient(Bundle ambientDetails)
É necessário chamar esse método pelo método correspondente da WearableActivity mãe.
|
nulo final |
onExitAmbient()
É necessário chamar esse método pelo método correspondente da WearableActivity mãe.
|
void |
onInflate(atividade da atividade, atributos AttributeSet, pacote savedInstanceState)
Analisam os atributos durante a inflação de uma hierarquia de visualização nos argumentos processados.
|
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(pacote outState)
Fornece um
Bundle para armazenar o estado do fragmento antes que ele seja destruído. |
void |
onStart()
|
void |
onStop()
|
void |
setArguments(argumentos de pacote)
|
Resumo do método herdado
Construtores públicos
public SupportMapFragment ()
Cria um fragmento de mapa. Esse construtor é público apenas para uso por um inflador. Use newInstance()
para criar um SupportMapFragment de forma programática.
Métodos públicos
public void getMapAsync (callback de OnMapReadyCallback)
Define um objeto de callback que será acionado quando a instância GoogleMap
estiver pronta para
ser usada.
Observações:
- É preciso chamar esse método a partir da linha de execução principal.
- O callback será executado na linha de execução principal.
- Caso o Google Play Services não esteja instalado no dispositivo, o callback não será acionado até que o usuário o instale.
- No caso raro em que o GoogleMap é destruído imediatamente após a criação, o retorno de chamada não é acionado.
- O objeto
GoogleMap
fornecido pelo callback não é nulo.
Parâmetros
callback | O objeto de callback que será acionado quando o mapa estiver pronto para ser utilizado. |
---|
public estático SupportMapFragment newInstance (GoogleMapOptions opções)
Cria um fragmento de mapa com as opções fornecidas.
Parâmetros
opções |
---|
public estático SupportMapFragment newInstance ()
Cria um fragmento de mapa usando as opções padrão.
public void onActivityCreated (Bundle savedInstanceState)
Parâmetros
savedInstanceState |
---|
public void onAttach (Atividade da atividade)
Parâmetros
atividade |
---|
public void onConfigurationChanged (configuração de configuração)
Parâmetros
config |
---|
public void onCreate (Bundle savedInstanceState)
Parâmetros
savedInstanceState |
---|
public Ver onCreateView (inflador de LayoutInflater, contêiner ViewGroup, pacote savedInstanceState)
Parâmetros
inflador | |
---|---|
contêiner | |
savedInstanceState |
public void onDestroy ()
public void onDestroyView ()
public final void onEnterAmbient (Bundle ambientDetails)
É necessário chamar esse método pelo método correspondente da WearableActivity mãe.
Parâmetros
ambientDetails |
---|
public void final onExitAmbient ()
É necessário chamar esse método pelo método correspondente da WearableActivity mãe.
public void onInflate (Activity activity, AttributeSet attrs, Bundle savedInstanceState)
Analisam os atributos durante a inflação de uma hierarquia de visualização nos argumentos processados.
Parâmetros
atividade | |
---|---|
attrs | |
savedInstanceState |
public void onLowMemory ()
public void onPause ()
public void onResume ()
public void onSaveInstanceState (Bundle outState)
Fornece um Bundle
para armazenar o estado do fragmento antes que ele seja destruído. Mais tarde, ele poderá ser recuperado quando onCreate(Bundle)
for chamado novamente.
Parâmetros
outState |
---|
public void onStart ()
public void onStop ()
public void setArguments (argumentos de pacote)
Parâmetros
args |
---|