So wenden Sie Stile für Strich und Füllung auf Begrenzungspolygone in einer Elementebene an:
Erstellen Sie eine Stil-Factory-Funktion, die die
FeatureLayer.StyleFactory
-Schnittstelle implementiert. Mit dieser Funktion wird die Stillogik für eine Feature-Ebene definiert.Rufen Sie
FeatureLayer.setFeatureStyle()
auf, um die Stil-Factory-Funktion auf die Elementebene anzuwenden.
In der folgenden Beispielkarte wird das Begrenzungspolygon für eine einzelne Region in einer Ortsebene hervorgehoben.
Stil-Funktion für die Werkseinstellungen erstellen
Die Stilfunktion der Stilvorlage wird auf jedes Polygon in der betroffenen Feature-Ebene angewendet, wenn Sie die Funktion auf der Feature-Ebene festlegen. Diese Funktion muss ein FeatureStyle
-Objekt zurückgeben, das angibt, wie das Polygon gestaltet werden soll.
Das Maps SDK for Android übergibt der Stil-Factory-Funktion eine Feature
-Instanz. Die Feature
-Instanz stellt die Metadaten des Elements dar und bietet Zugriff auf die Metadaten in der Stil-Factory-Funktion.
Die Stil-Factory-Funktion sollte immer konsistente Ergebnisse zurückgeben, wenn sie angewendet wird. Wenn Sie z. B. eine Reihe von Elementen nach dem Zufallsprinzip einfärben wollen, sollte die zufällige Farbauswahl nicht in der Stilfunktion für Elemente erfolgen, da dies zu unbeabsichtigten Ergebnissen führen würde.
Da diese Funktion für jedes Element in einer Ebene ausgeführt wird, ist die Optimierung wichtig. So vermeiden Sie Auswirkungen auf die Renderingzeit:
Aktivieren Sie nur die benötigten Feature-Ebenen.
Rufen Sie
FeatureLayer.setFeatureStyle(null)
auf, wenn eine Featureebene nicht mehr verwendet wird.
Polygonstrich und -füllung festlegen
Beim Gestalten eines Begrenzungspolygons in der Stilfabrik-Funktion können Sie Folgendes festlegen:
Strichfarbe und Deckkraft des Polygonrands im ARGB-Farbformat, wie von der Klasse
Color
definiert. Der Standardwert ist „transparent“ (0x00000000).Strichbreite des Polygonrahmens in Bildschirmpixeln. Der Standardwert ist 2.
Füllfarbe und Deckkraft des Polygons im ARGB-Farbformat, wie von der Klasse
Color
definiert. Der Standardwert ist transparent (0x00000000).
Orts-IDs für die Element-Ausrichtung abrufen
In vielen Anwendungen werden Stilelemente anhand des Standorts eines Elements angewendet. So können Sie beispielsweise unterschiedliche Stile auf verschiedene Länder, Gebiete oder Regionen anwenden. Der Standort des Elements wird durch eine Orts-ID dargestellt.
Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. So rufen Sie eine Orts-ID ab:
- Verwenden Sie Places APIs und Geocoding, um anhand des Namens nach Regionen zu suchen und Orts-IDs für Regionen innerhalb der angegebenen Grenzen abzurufen.
- Rufen Sie Daten von Click-Events ab. Dabei wird das Element für die angeklickte Region zurückgegeben und Sie erhalten Zugriff auf die Orts-ID und die Elementtyp-Kategorie.
Die Abdeckung variiert je nach Region. Weitere Informationen
Geografische Namen sind aus vielen Quellen verfügbar, etwa vom United States Geological Survey (USGS) Board on Geographic Names oder aus den US Gazetteer Files.
PlaceFeature verwenden, um eine Orts-ID abzurufen
Die Klasse PlaceFeature
ist eine Unterklasse der Klasse Feature
.
Es stellt eine Ortsfeature (eine Feature mit einer Orts-ID) dar, die Features vom Typ ADMINISTRATIVE_AREA_LEVEL_1
, ADMINISTRATIVE_AREA_LEVEL_2
, COUNTRY
, LOCALITY
, POSTAL_CODE
und SCHOOL_DISTRICT
enthält.
Wenn die Orts-ID verfügbar ist, übergibt das Maps SDK for Android eine Instanz von PlaceFeature
an die Style-Factory-Funktion, damit Sie den Standort der Funktion ermitteln können.
Beispiel für eine Style-Factory
In diesem Beispiel wird eine Stil-Factory-Funktion auf ein Polygon auf der Element-Ebene „Ortsteil“ angewendet. Die Stil-Factory-Funktion ermittelt die Orts-ID des Elements anhand der PlaceFeature
-Instanz. Wenn die Orts-ID für Hana auf Hawaii steht, wendet die Funktion einen benutzerdefinierten Füllungs- und Strichstil auf das Polygon an:
Falls noch nicht geschehen, erstellen Sie eine neue Karten-ID und einen neuen Kartenstil. Folgen Sie dazu der Anleitung unter Erste Schritte. Aktivieren Sie auf jeden Fall die Element-Ebene Ort.
Rufen Sie einen Verweis auf die Element-Ebene „Ort“ ab, wenn die Karte initialisiert wird.
Java
private FeatureLayer localityLayer;
@Override public void onMapReady(GoogleMap map) { // Get the LOCALITY feature layer. localityLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder() .featureType(FeatureType.LOCALITY) .build());
// Apply style factory function to LOCALITY layer. styleLocalityLayer(); }Kotlin
private var localityLayer: FeatureLayer? = null
override fun onMapReady(googleMap: GoogleMap) { // Get the LOCALITY feature layer. localityLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder() .featureType(FeatureType.LOCALITY) .build())
// Apply style factory function to LOCALITY layer. styleLocalityLayer() }Erstellen Sie eine Stil-Factory-Funktion und wenden Sie sie auf die Ortsebene an.
Im folgenden Beispiel wird die Funktion nur angewendet, wenn die Orts-ID des Elements für Hana, Hawaii („ChIJ0zQtYiWsVHkRk8lRoB1RNPo“) ist. Wenn die angegebene Orts-ID nicht für Hana, Hawaii, ist, wird der Stil nicht angewendet.
Java
private void styleLocalityLayer() {
// Create the style factory function. FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
// Check if the feature is an instance of PlaceFeature, // which contains a place ID. if (feature instanceof PlaceFeature) { PlaceFeature placeFeature = (PlaceFeature) feature;
// Determine if the place ID is for Hana, HI. if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
// Use FeatureStyle.Builder to configure the FeatureStyle object // returned by the style factory function. return new FeatureStyle.Builder() // Define a style with purple fill at 50% opacity and solid purple border. .fillColor(0x80810FCB) .strokeColor(0xFF810FCB) .build(); } } return null; };
// Apply the style factory function to the feature layer. localityLayer.setFeatureStyle(styleFactory); }Kotlin
private fun styleLocalityLayer() {
// Create the style factory function. val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
// Check if the feature is an instance of PlaceFeature, // which contains a place ID. if (feature is PlaceFeature) { val placeFeature: PlaceFeature = feature as PlaceFeature
// Determine if the place ID is for Hana, HI. if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
// Use FeatureStyle.Builder to configure the FeatureStyle object // returned by the style factory function. return@StyleFactory FeatureStyle.Builder() // Define a style with purple fill at 50% opacity and // solid purple border. .fillColor(0x80810FCB.toInt()) .strokeColor(0xFF810FCB.toInt()) .build() } } return@StyleFactory null }
// Apply the style factory function to the feature layer. localityLayer?.setFeatureStyle(styleFactory) }
Stile von einer Ebene entfernen
Wenn Sie Stile von einer Ebene entfernen möchten, rufen Sie FeatureLayer.setFeatureStyle(null)
auf.