O Location SDK oferece um conjunto simples de interfaces para serviços baseados em localização (LBS). Use as APIs de localização para obter resultados de posicionamento.
O componente Location suporta dois métodos de integração: modo AAR nativo e modo de componente.
Pré-requisitos
Se você usar o método de AAR nativo para integração, conclua primeiro as etapas em Adicionar o mPaaS ao seu projeto.
Se optar pela integração baseada em componentes, conclua previamente o Fluxo do modo de componente.
Adicionar o SDK
Modo AAR nativo
Use o Component Management (AAR) para instale o componente Location no projeto. Para mais informações, consulte Gerenciamento de Componentes AAR.
Modo de componente
Instale o componente Location nos projetos Portal e Bundle pelo Component Management. Para mais detalhes, consulte Gerenciar dependências de componentes.
Solicitar uma chave do Amap
Antes de usar os serviços LBS, crie uma conta e obtenha uma chave de localização na Plataforma Aberta do Amap. O exemplo a seguir mostra uma chave:
Configure o AndroidManifest
No arquivo AndroidManifest.xml, adicione a chave de localização do Amap e o serviço de localização correspondente.
<!--Amap location Key-->
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="Enter your Amap key" />
<!--Amap location Service-->
<service android:name="com.amap.api.location.APSService"></service>A partir da versão 10.1.68.18, o recurso de check-in automático do componente Location vem desativado por padrão. Para ative essa funcionalidade, adicione manualmente a seguinte configuração ao arquivo AndroidManifest.xml:
<meta-data android:name="com.mpaas.lbs.autoCheckIn" android:value="true" />Referência da API
Chamar o recurso de localização
Por padrão, a localização é resolvida no nível de distrito ou município. Para obter precisão no nível de rua, consulte as outras APIs relacionadas.
LBSLocationManagerProxy.getInstance().requestLocationUpdates(MainActivity.this, new LBSLocationListener() {
@Override
public void onLocationUpdate(LBSLocation lbsLocation) {
Toast.makeText(MainActivity.this, "lbsLocation is " + lbsLocation.getAddress(), Toast.LENGTH_LONG).show();
}
@Override
public void onLocationFailed(int i) {
Toast.makeText(MainActivity.this,
"onLocationFailed" + i, Toast.LENGTH_SHORT).show();
}
});Outras APIs relacionadas
/**
* Registers location updates. The location is accurate to the district level.
*/
public void requestLocationUpdates(Context context, LBSLocationListener locationListener)
/**
* Registers location updates. Use this API if you need street-level accuracy.
* gpsEnable: false indicates district-level accuracy. true indicates street-level accuracy, which provides higher precision but consumes more resources.
* miniInterval: The location update interval. For example, LBSLocationManagerProxy.DEFAULT_LOCATION_INTERVAL.
* overtime: The location timeout period. For example, LBSLocationManagerProxy.LOCATION_TIME_OUT.
* isNeedAddress: true indicates that reverse geocoding is required. false indicates that only the latitude and longitude are required.
* bizType: The business type. Set to null.
*/
public void doRequestLocationUpdates(Context context, boolean gpsEnable, LBSLocationListener locationListener, long miniInterval, long overtime, boolean isNeedAddress, String bizType)
// Removes the callback for location registration.
public void removeUpdates(Context context, LBSLocationListener listener)
// Gets the last known successful location.
public LBSLocation getLastKnownLocation(Context context)