Utility Maps SDK for Android

Seleziona la piattaforma: Android iOS

Cerchi funzionalità avanzate da aggiungere alle tue mappe? La libreria di utilità di Maps SDK for Android è una libreria open source di classi utili per una serie di applicazioni. Il repository GitHub include le classi di utilità e un'app demo che illustra l'utilizzo di ogni classe.

In questo video, Chris Broadfoot parla della libreria di utilità, con particolare attenzione alla decodifica delle polilinee, alla geometria sferica e alle icone a fumetto.

Configurazione rapida

Per installare la libreria di utilità di Maps SDK for Android, segui la guida alla configurazione.

Le utenze

	Importa GeoJSON nella mappa Puoi archiviare le caratteristiche in formato GeoJSON e utilizzare questa utilità per eseguirne il rendering come livello sopra una mappa. Chiama addLayer() per aggiungere i dati GeoJSON alla mappa. Puoi anche aggiungere singole caratteristiche chiamando addFeature() e passando un oggetto GeoJsonFeature. Per maggiori dettagli, consulta la documentazione sull'utilità GeoJSON di Google Maps per Android.
	Importa KML nella mappa Utilizzando questa utilità, puoi convertire gli oggetti KML in forme geografiche e visualizzarli come un livello sopra una mappa. Chiama addLayerToMap() per aggiungere il livello alla mappa. Puoi accedere alle proprietà di un oggetto KML chiamando getProperties() su qualsiasi segnaposto, overlay del suolo, documento o cartella. Per maggiori dettagli, consulta la documentazione sull'utilità KML di Google Maps per Android.
	Aggiungi mappe termiche alla mappa Le mappe termiche aiutano i visualizzatori a comprendere la distribuzione e l'intensità relativa dei punti dati su una mappa. Anziché posizionare un indicatore in ogni località, le mappe termiche utilizzano il colore e la forma per rappresentare la distribuzione dei dati. Crea un HeatmapTileProvider, passandogli una raccolta di oggetti LatLng che rappresentano i punti d'interesse sulla mappa. Poi crea un nuovo TileOverlay, passandogli il provider di riquadri della mappa termica, e aggiungi l'overlay riquadri alla mappa. Per maggiori dettagli, consulta la documentazione sull'utilità per le mappe termiche di Google Maps per Android.
	Personalizza gli indicatori con icone a fumetto Aggiungi un IconGenerator per visualizzare snippet di informazioni sui tuoi indicatori. Questa utilità consente di far assomigliare le icone degli indicatori alle finestre informative, in quanto l'indicatore stesso può contenere testo e altri contenuti. Il vantaggio è che puoi tenere aperti più indicatori contemporaneamente, mentre è possibile aprire una sola finestra informativa alla volta. Puoi anche applicare uno stile agli indicatori, modificare l'orientamento dell'indicatore e/o dei contenuti e modificare l'immagine di sfondo/nine-patch dell'indicatore.
	Anima gli indicatori Puoi animare un indicatore in modo che si sposti senza problemi dalla sua posizione attuale a una nuova posizione. La classe AnimationUtil fornisce questa funzionalità. Per un esempio di come utilizzarlo, consulta AnimationUtilDemoActivity nel repository GitHub della libreria di utilità.
	Gestisci i raggruppatori di indicatori ClusterManager ti aiuta a gestire più indicatori a diversi livelli di zoom. Ciò significa che puoi inserire un numero elevato di indicatori su una mappa senza renderla difficile da leggere. Quando un utente visualizza la mappa con un livello di zoom elevato, i singoli indicatori vengono visualizzati sulla mappa. Quando l'utente diminuisce lo zoom a un livello di zoom inferiore, gli indicatori si raggruppano in cluster per facilitare la visualizzazione della mappa. Per maggiori dettagli, consulta la documentazione sull'utilità di raggruppamento degli indicatori di Google Maps per Android.
	Aggiungi più livelli alla stessa mappa Puoi mostrare elementi da GeoJSON, KML e cluster, nonché i tuoi indicatori, polilinee e poligoni, tutti sulla stessa mappa. Puoi anche rendere interattivi questi livelli aggiungendo un click listener a ciascuno. Per farlo, crea un'istanza delle classi MarkerManager, GroundOverlayManager, PolygonManager e PolylineManager e passale ai costruttori di GeoJsonLayer, KmlLayer e ClusterManager quando li configuri. Puoi quindi utilizzare queste classi Manager direttamente per aggiungere i tuoi indicatori, polilinee e poligoni alla mappa. Per maggiori dettagli, consulta la documentazione sulla demo di Google Maps Android Multi Layer.
	Codifica e decodifica le polilinee La classe PolyUtil converte polilinee e poligoni codificati in coordinate di latitudine/longitudine e converte le coordinate in polilinee e poligoni codificati. In Google Maps, le coordinate di latitudine e longitudine che definiscono una polilinea o un poligono vengono memorizzate come stringa codificata. Consulta la spiegazione dettagliata della codifica delle polilinee. Potresti ricevere questa stringa codificata in una risposta da un'API di Google, ad esempio l'API Directions (legacy). Puoi utilizzare PolyUtil nella libreria di utilità di Maps SDK for Android per codificare una sequenza di coordinate di latitudine/longitudine ("LatLng") in una stringa di percorso codificata e per decodificare una stringa di percorso codificata in una sequenza di LatLng. In questo modo, l'interoperabilità con i servizi web delle API di Google Maps è garantita.
	Calcola distanze, aree e direzioni con la geometria sferica Utilizzando le utilità di geometria sferica in SphericalUtil, puoi calcolare distanze, aree e direzioni in base a latitudini e longitudini. Ecco alcuni dei metodi disponibili nell'utilità: computeDistanceBetween(): restituisce la distanza, in metri, tra due coordinate di latitudine/longitudine. computeHeading(): restituisce il rilevamento, in gradi, tra due coordinate di latitudine/longitudine. computeArea(): restituisce l'area, in metri quadrati, di un percorso chiuso sulla Terra. interpolate(): restituisce le coordinate di latitudine/longitudine di un punto che si trova a una determinata frazione della distanza tra due punti specificati. Puoi utilizzarlo, ad esempio, per animare un indicatore tra due punti. Consulta la documentazione di riferimento per un elenco completo dei metodi nell'utilità.
	Controlla se una località è supportata in Street View La classe StreetViewUtil fornisce funzionalità per verificare se una località è supportata in Street View. Puoi evitare errori durante l'aggiunta di una panoramica in Street View a un'app per Android chiamando questa utilità di metadati e aggiungendo una panoramica in Street View solo se la risposta è OK. Per maggiori dettagli, consulta la documentazione sull'utilità dei metadati di Street View su GitHub.