Questa guida descrive i modi in cui puoi personalizzare la mappa visualizzata nel tuo App per Android quando segui un viaggio. Puoi personalizzare l'aspetto la mappa nei seguenti modi:
- Applica gli stili alla mappa utilizzando la Personalizzazione delle mappe basata su cloud
- Regolare la fotocamera per mettere a fuoco il percorso
- Personalizzare gli indicatori
- Personalizzare le polilinee
Applica uno stile alla mappa utilizzando la Personalizzazione delle mappe basata su cloud
Personalizza l'aspetto del componente Maps utilizzando le mappe basate su cloud stili. Puoi creare e modificare gli stili di mappa nella console Google Cloud per qualsiasi delle tue app che utilizzano Google Maps, senza richiedere alcuna modifica al codice. Per ulteriori informazioni, vedi Personalizzazione delle mappe basata su cloud.
Entrambi i campi
ConsumerMapView
e ai
ConsumerMapFragment
supportano la personalizzazione delle mappe basata su cloud.
Per utilizzare la Personalizzazione delle mappe basata su cloud, assicurati che le mappe selezionate
Il renderer è LATEST
. Le seguenti sezioni mostrano esempi di utilizzo
la personalizzazione delle mappe basata su cloud con il tuo progetto.
ConsumerMapView
Per utilizzare la Personalizzazione delle mappe basata su cloud in ConsumerMapView
, imposta la
campo mapId
su GoogleMapOptions
e passa il GoogleMapOptions
a
getConsumerGoogleMapAsync(ConsumerMapReadyCallback, Fragment,
GoogleMapOptions)
or getConsumerGoogleMapAsync(ConsumerMapReadyCallback, FragmentActivity,
GoogleMapOptions)
Esempio
Java
public class SampleAppActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ConsumerMapView mapView = findViewById(R.id.consumer_map_view);
if (mapView != null) {
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
mapView.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId);
}
}
}
Kotlin
class SampleAppActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val mapView = findViewById(R.id.consumer_map_view) as ConsumerMapView
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
mapView.getConsumerGoogleMapAsync(
object : ConsumerGoogleMap.ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
},
/* fragmentActivity= */ this,
/* googleMapOptions= */ optionsWithMapId)
}
}
ConsumerMapFragment
Esistono due modi per utilizzare la Personalizzazione delle mappe basata su cloud ConsumerMapFragments:
- in modo statico con il file XML.
- In modo dinamico con
newInstance
.
In modo statico con il file XML
Per utilizzare la personalizzazione delle mappe basata su cloud con il file XML nel
ConsumerMapFragment
, aggiungi l'attributo XML map:mapId
con il valore specificato
mapId
. Vedi il seguente esempio:
<fragment
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.libraries.mapsplatform.transportation.consumer.view.ConsumerMapFragment"
android:id="@+id/consumer_map_fragment"
map:mapId="map-id"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
In modo dinamico con newInstance
Per utilizzare la Personalizzazione delle mappe basata su cloud con newInstance
in
ConsumerMapFragment
, imposta il campo mapId
su GoogleMapOptions
e supera il
Da GoogleMapOptions
a newInstance
. Vedi il seguente esempio:
Java
public class SampleFragmentJ extends Fragment {
@Override
public View onCreateView(
@NonNull LayoutInflater inflater,
@Nullable ViewGroup container,
@Nullable Bundle savedInstanceState) {
final View view = inflater.inflate(R.layout.consumer_map_fragment, container, false);
GoogleMapOptions optionsWithMapId = new GoogleMapOptions().mapId("map-id");
ConsumerMapFragment consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId);
getParentFragmentManager()
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit();
consumerMapFragment.getConsumerGoogleMapAsync(
new ConsumerMapReadyCallback() {
@Override
public void onConsumerMapReady(@NonNull ConsumerGoogleMap consumerGoogleMap) {
// ...
}
});
return view;
}
}
Kotlin
class SampleFragment : Fragment() {
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.consumer_map_fragment, container, false)
val optionsWithMapId = GoogleMapOptions().mapId("map-id")
val consumerMapFragment = ConsumerMapFragment.newInstance(optionsWithMapId)
parentFragmentManager
.beginTransaction()
.add(R.id.consumer_map_fragment, consumerMapFragment)
.commit()
consumerMapFragment.getConsumerGoogleMapAsync(
object : ConsumerMapReadyCallback() {
override fun onConsumerMapReady(consumerGoogleMap: ConsumerGoogleMap) {
// ...
}
})
return view
}
}
Regola lo zoom della fotocamera per mettere a fuoco un percorso
Durante una sessione di condivisione attiva del percorso, puoi gestire lo zoom e possono essere concentrati in uno di questi due modi:
AutoCamera
: se vuoi utilizzareAutoCamera
, non hai fare qualsiasi cosa. La fotocamera segue il percorso. Per maggiori dettagli, vediAutoCamera
Personalizza il comportamento della videocamera: per personalizzare il comportamento della videocamera, devi disattivare
AutoCamera
e poi apportare le personalizzazioni. Per maggiori dettagli, consulta la sezione Personalizzare il comportamento della videocamera.
AutoCamera
centra la fotocamera
L'SDK consumer fornisce una funzionalità AutoCamera
attivata per impostazione predefinita
sul pulsante La mia posizione integrato per Maps SDK. La fotocamera aumenta lo zoom fino a
concentrarsi sul percorso di condivisione del viaggio e sulla tappa successiva del viaggio.
Se vuoi utilizzare AutoCamera
, assicurati di abilitarlo. Per ulteriori dettagli, vedi
isAutoCameraEnabled
Per maggiori dettagli sul pulsante La mia posizione, vedi Pulsante La mia posizione nella documentazione dell'API Maps JavaScript.
Personalizza il comportamento della videocamera
Per un maggiore controllo sul comportamento della videocamera, segui questi passaggi per disattivarla
AutoCamera
e personalizza il comportamento della videocamera manualmente.
Disattiva
AutoCamera
utilizzando ConsumerController.setAutoCameraEnabled().Recuperare i limiti consigliati per la fotocamera utilizzando ConsumerController.getCameraUpdate().
Fornisci
CameraUpdate
come argomento a una delle seguenti funzioni di Android: