Skip to content

Commit f4654e6

Browse files
kikosodkhawk
kikoso
and
dkhawk
authored
feat: Data-Driven styling samples (#1771)
* fix: import rememberMarkerState and use the marker state correctly * feat: dataset styling Kotlin samples * feat: added DataDrivenBoundariesActivity.kt * feat: added DataDrivenBoundariesActivity * feat: added documentation * feat: added header * chore: changed MY_MAP_ID to DEMO_MAP_ID * feat: moved data files to raw * feat: added DataDrivenBoundariesActivity * feat: removed unused files * feat: map id * chore: replace System.out.println with Log.d * feat: added region tags * feat: added different set of DDS * feat: added different set of DDS * feat: replacing files feat: replacing files * feat: replacing files * feat: compileSdk 35 * feat: compileSdk 35 * chore: updated README file * feat: trying to force different datasets * feat: updated samples * feat: Add data-driven styling for datasets This commit introduces data-driven styling for datasets in the ApiDemos application. The following changes were made: Added a custom Application class (ApiDemoApplication) to check for the presence and validity of the API key during startup. Added a new data structure (DataSet) to hold information about each dataset, including its label, dataset ID, location, and styling callback. Updated the DataDrivenDatasetStylingActivity to use the new data structure and styling callbacks. Rename the dataset input files to better reflect there contents. * fix: moves the dataset ids to the secrets.properties file * feat: significant rewrite to of DataDrivenDatasetStylingActivity * Makes the app look better on full screen with a cutout * Uses material elements * Switch to using secrets for the data set ids * more of a convenience to prevent having to remove the ids when submitting * moves dataset data files to common area since they are not used directly by the app * Detailed instructions for uploading the data to console (WIP) * fix: exports the data driven styling activities so they can be run directly * feat: added header * feat: change ubuntu-latest * feat: change ubuntu-latest * feat: change ubuntu-latest --------- Co-authored-by: dkhawk <107309+dkhawk@users.noreply.github.com>
1 parent 95f70aa commit f4654e6

File tree

128 files changed

+2189
-133
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

128 files changed

+2189
-133
lines changed

‎.github/workflows/build.yml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,8 +45,12 @@ jobs:
4545
- name: Build and check
4646
run: |
4747
cd ApiDemos
48-
for dir in ./*/ ; do ( cd "$dir" && ./gradlew buildDebugPreBundle ); done
49-
48+
for dir in ./*/ ; do
49+
if [[ "$dir" != "./resources/" ]]; then
50+
( cd "$dir" && ./gradlew buildDebugPreBundle )
51+
fi
52+
done
53+
5054
build-WearOS:
5155
runs-on: ubuntu-latest
5256
timeout-minutes: 45

‎ApiDemos/java/app/build.gradle.kts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/*
2-
* Copyright 2024 Google LLC
2+
* Copyright 2025 Google LLC
33
*
44
* Licensed under the Apache License, Version 2.0 (the "License");
55
* you may not use this file except in compliance with the License.

‎ApiDemos/java/app/src/main/AndroidManifest.xml

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!--
3-
Copyright 2024 Google LLC
3+
Copyright 2025 Google LLC
44
55
Licensed under the Apache License, Version 2.0 (the "License");
66
you may not use this file except in compliance with the License.
@@ -33,6 +33,7 @@ limitations under the License.
3333
android:maxSdkVersion="22" />
3434

3535
<application
36+
android:name=".ApiDemoApplication"
3637
android:allowBackup="true"
3738
android:icon="@mipmap/ic_launcher"
3839
android:label="@string/demo_title"
@@ -89,6 +90,14 @@ limitations under the License.
8990
android:name=".CircleDemoActivity"
9091
android:exported="true"
9192
android:label="@string/circle_demo_label" />
93+
<activity
94+
android:name=".DataDrivenBoundariesActivity"
95+
android:exported="true"
96+
android:label="@string/data_driven_boundaries_label" />
97+
<activity
98+
android:name=".DataDrivenDatasetStylingActivity"
99+
android:exported="true"
100+
android:label="@string/data_driven_styling_label" />
92101
<activity
93102
android:name=".EventsDemoActivity"
94103
android:exported="true"

‎ApiDemos/java/app/src/main/java/com/example/mapdemo/ApiDemoApplication.java

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
/*
2+
* Copyright 2025 Google LLC
3+
*
4+
* Licensed under the Apache License, Version 2.0 (the "License");
5+
* you may not use this file except in compliance with the License.
6+
* You may obtain a copy of the License at
7+
*
8+
* http://www.apache.org/licenses/LICENSE-2.0
9+
*
10+
* Unless required by applicable law or agreed to in writing, software
11+
* distributed under the License is distributed on an "AS IS" BASIS,
12+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
* See the License for the specific language governing permissions and
14+
* limitations under the License.
15+
*/
16+
17+
package com.example.mapdemo;
18+
19+
import android.app.Application;
20+
import android.content.pm.ApplicationInfo;
21+
import android.content.pm.PackageManager;
22+
import android.os.Bundle;
23+
import android.util.Log;
24+
import android.widget.Toast;
25+
26+
import java.util.Objects;
27+
28+
/**
29+
* {@code ApiDemoApplication} is a custom Application class for the API demo.
30+
*
31+
* <p>This class is responsible for application-wide initialization and setup,
32+
* such as checking for the presence and validity of the API key during the
33+
* application's startup.</p>
34+
*
35+
* <p>It extends the {@link Application} class and overrides the {@link #onCreate()}
36+
* method to perform these initialization tasks.</p>
37+
*/
38+
public class ApiDemoApplication extends Application {
39+
private static final String TAG = "ApiDemoApplication";
40+
41+
@Override
42+
public void onCreate() {
43+
super.onCreate();
44+
Log.d(TAG, "onCreate called");
45+
checkApiKey();
46+
}
47+
48+
/**
49+
* Checks if the API key for Google Maps is properly configured in the application's metadata.
50+
* <p>
51+
* This method retrieves the API key from the application's metadata, specifically looking for
52+
* a string value associated with the key "com.google.android.geo.API_KEY".
53+
* The key must be present, not blank, and not set to the placeholder value "DEFAULT_API_KEY".
54+
* <p>
55+
* If any of these checks fail, a Toast message is displayed indicating that the API key is missing or
56+
* incorrectly configured, and a RuntimeException is thrown.
57+
* <p>
58+
*/
59+
private void checkApiKey() {
60+
try {
61+
ApplicationInfo appInfo = getPackageManager().getApplicationInfo(getPackageName(), PackageManager.GET_META_DATA);
62+
Bundle bundle = Objects.requireNonNull(appInfo.metaData);
63+
64+
String apiKey = bundle.getString("com.google.android.geo.API_KEY"); // Key name is important!
65+
66+
if (apiKey == null || apiKey.isBlank() || apiKey.equals("DEFAULT_API_KEY")) {
67+
Toast.makeText(this, "API Key was not set in secrets.properties", Toast.LENGTH_LONG).show();
68+
throw new RuntimeException("API Key was not set in secrets.properties");
69+
}
70+
} catch (PackageManager.NameNotFoundException e) {
71+
Log.e(TAG, "Package name not found.", e);
72+
throw new RuntimeException("Error getting package info.", e);
73+
} catch (NullPointerException e) {
74+
Log.e(TAG, "Error accessing meta-data.", e); // Handle the case where meta-data is completely missing.
75+
throw new RuntimeException("Error accessing meta-data in manifest", e);
76+
}
77+
}
78+
}

‎ApiDemos/java/app/src/main/java/com/example/mapdemo/DataDrivenBoundariesActivity.java

Lines changed: 228 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,228 @@
1+
// Copyright 2025 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
package com.example.mapdemo;
15+
16+
import android.graphics.Color;
17+
import android.os.Build;
18+
import android.os.Bundle;
19+
import android.util.Log;
20+
21+
import androidx.annotation.RequiresApi;
22+
import androidx.appcompat.app.AppCompatActivity;
23+
24+
import com.google.android.gms.maps.CameraUpdateFactory;
25+
import com.google.android.gms.maps.GoogleMap;
26+
import com.google.android.gms.maps.OnMapReadyCallback;
27+
import com.google.android.gms.maps.SupportMapFragment;
28+
import com.google.android.gms.maps.model.Feature;
29+
import com.google.android.gms.maps.model.FeatureClickEvent;
30+
import com.google.android.gms.maps.model.FeatureLayer;
31+
import com.google.android.gms.maps.model.FeatureLayerOptions;
32+
import com.google.android.gms.maps.model.FeatureStyle;
33+
import com.google.android.gms.maps.model.FeatureType;
34+
import com.google.android.gms.maps.model.LatLng;
35+
import com.google.android.gms.maps.model.MapCapabilities;
36+
import com.google.android.gms.maps.model.PlaceFeature;
37+
38+
import java.util.ArrayList;
39+
import java.util.List;
40+
41+
/**
42+
* This sample showcases how to use the Data-driven styling for boundaries. For more information
43+
* on how the Data-driven styling for boundaries work, check out the following link:
44+
* https://developers.google.com/maps/documentation/android-sdk/dds-boundaries/overview
45+
*/
46+
// [START maps_android_data_driven_styling_boundaries]
47+
public class DataDrivenBoundariesActivity extends AppCompatActivity implements OnMapReadyCallback,
48+
FeatureLayer.OnFeatureClickListener {
49+
50+
private GoogleMap map;
51+
52+
private FeatureLayer localityLayer = null;
53+
private FeatureLayer areaLevel1Layer = null;
54+
private FeatureLayer countryLayer = null;
55+
56+
private static final String TAG = DataDrivenBoundariesActivity.class.getName();
57+
58+
private static final LatLng HANA_HAWAII = new LatLng(20.7522, -155.9877); // Hana, Hawaii
59+
private static final LatLng CENTER_US = new LatLng(39.8283, -98.5795); // Approximate geographical center of the contiguous US
60+
61+
@Override
62+
protected void onCreate(Bundle savedInstanceState) {
63+
super.onCreate(savedInstanceState);
64+
setContentView(R.layout.data_driven_boundaries_demo);
65+
66+
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
67+
if (mapFragment != null) {
68+
mapFragment.getMapAsync(this);
69+
}
70+
71+
findViewById(R.id.button_hawaii).setOnClickListener(view -> centerMapOnLocation(HANA_HAWAII, 13.5f));
72+
findViewById(R.id.button_us).setOnClickListener(view -> centerMapOnLocation(CENTER_US, 1f));
73+
}
74+
75+
private void centerMapOnLocation(LatLng location, float zoomLevel) {
76+
map.moveCamera(CameraUpdateFactory.newLatLngZoom(location, zoomLevel));
77+
}
78+
79+
@RequiresApi(Build.VERSION_CODES.O)
80+
@Override
81+
public void onMapReady(GoogleMap googleMap) {
82+
this.map = googleMap;
83+
MapCapabilities capabilities = map.getMapCapabilities();
84+
Log.d(TAG, "Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());
85+
86+
// Get the LOCALITY feature layer.
87+
localityLayer = googleMap.getFeatureLayer(
88+
new FeatureLayerOptions.Builder()
89+
.featureType(FeatureType.LOCALITY)
90+
.build()
91+
);
92+
93+
// Apply style factory function to LOCALITY layer.
94+
styleLocalityLayer();
95+
96+
// Get the ADMINISTRATIVE_AREA_LEVEL_1 feature layer.
97+
areaLevel1Layer = googleMap.getFeatureLayer(
98+
new FeatureLayerOptions.Builder()
99+
.featureType(FeatureType.ADMINISTRATIVE_AREA_LEVEL_1)
100+
.build()
101+
);
102+
103+
// Apply style factory function to ADMINISTRATIVE_AREA_LEVEL_1 layer.
104+
styleAreaLevel1Layer();
105+
106+
// Get the COUNTRY feature layer.
107+
countryLayer = googleMap.getFeatureLayer(
108+
new FeatureLayerOptions.Builder()
109+
.featureType(FeatureType.COUNTRY)
110+
.build()
111+
);
112+
113+
// Register the click event handler for the Country layer.
114+
countryLayer.addOnFeatureClickListener(this);
115+
116+
// Apply default style to all countries on load to enable clicking.
117+
styleCountryLayer();
118+
}
119+
120+
private void styleLocalityLayer() {
121+
// Create the style factory function.
122+
FeatureLayer.StyleFactory styleFactory = feature -> {
123+
// Check if the feature is an instance of PlaceFeature,
124+
// which contains a place ID.
125+
if (feature instanceof PlaceFeature placeFeature) {
126+
127+
// Determine if the place ID is for Hana, HI.
128+
if ("ChIJ0zQtYiWsVHkRk8lRoB1RNPo".equals(placeFeature.getPlaceId())) {
129+
// Use FeatureStyle.Builder to configure the FeatureStyle object
130+
// returned by the style factory function.
131+
return new FeatureStyle.Builder()
132+
// Define a style with purple fill at 50% opacity and
133+
// solid purple border.
134+
.fillColor(0x80810FCB)
135+
.strokeColor(0xFF810FCB)
136+
.build();
137+
}
138+
}
139+
return null;
140+
};
141+
142+
// Apply the style factory function to the feature layer.
143+
if (localityLayer != null) {
144+
localityLayer.setFeatureStyle(styleFactory);
145+
}
146+
}
147+
148+
private void styleAreaLevel1Layer() {
149+
FeatureLayer.StyleFactory styleFactory = feature -> {
150+
if (feature instanceof PlaceFeature placeFeature) {
151+
152+
// Return a hueColor in the range [-299,299]. If the value is
153+
// negative, add 300 to make the value positive.
154+
int hueColor = placeFeature.getPlaceId().hashCode() % 300;
155+
if (hueColor < 0) {
156+
hueColor += 300;
157+
}
158+
return new FeatureStyle.Builder()
159+
// Set the fill color for the state based on the hashed hue color.
160+
.fillColor(Color.HSVToColor(150, new float[]{hueColor, 1f, 1f}))
161+
.build();
162+
}
163+
return null;
164+
};
165+
166+
// Apply the style factory function to the feature layer.
167+
if (areaLevel1Layer != null) {
168+
areaLevel1Layer.setFeatureStyle(styleFactory);
169+
}
170+
}
171+
172+
// Set default fill and border for all countries to ensure that they respond
173+
// to click events.
174+
@RequiresApi(Build.VERSION_CODES.O)
175+
private void styleCountryLayer() {
176+
FeatureLayer.StyleFactory styleFactory = feature -> new FeatureStyle.Builder()
177+
// Set the fill color for the country as white with a 10% opacity.
178+
// This requires minApi 26
179+
.fillColor(Color.argb(0.1f, 0f, 0f, 0f))
180+
// Set border color to solid black.
181+
.strokeColor(Color.BLACK)
182+
.build();
183+
184+
// Apply the style factory function to the country feature layer.
185+
if (countryLayer != null) {
186+
countryLayer.setFeatureStyle(styleFactory);
187+
}
188+
}
189+
190+
// Define the click event handler.
191+
@Override
192+
public void onFeatureClick(FeatureClickEvent event) {
193+
// Get the list of features affected by the click using
194+
// getPlaceIds() defined below.
195+
List<String> selectedPlaceIds = getPlaceIds(event.getFeatures());
196+
if (!selectedPlaceIds.isEmpty()) {
197+
FeatureLayer.StyleFactory styleFactory = feature -> {
198+
// Use PlaceFeature to get the placeID of the country.
199+
if (feature instanceof PlaceFeature) {
200+
if (selectedPlaceIds.contains(((PlaceFeature) feature).getPlaceId())) {
201+
return new FeatureStyle.Builder()
202+
// Set the fill color to red.
203+
.fillColor(Color.RED)
204+
.build();
205+
}
206+
}
207+
return null;
208+
};
209+
210+
// Apply the style factory function to the feature layer.
211+
if (countryLayer != null) {
212+
countryLayer.setFeatureStyle(styleFactory);
213+
}
214+
}
215+
}
216+
217+
// Get a List of place IDs from the FeatureClickEvent object.
218+
private List<String> getPlaceIds(List<Feature> features) {
219+
List<String> placeIds = new ArrayList<>();
220+
for (Feature feature : features) {
221+
if (feature instanceof PlaceFeature) {
222+
placeIds.add(((PlaceFeature) feature).getPlaceId());
223+
}
224+
}
225+
return placeIds;
226+
}
227+
}
228+
// [END maps_android_data_driven_styling_boundaries]

0 commit comments

Comments
 (0)