[google_maps_flutter] Add Advanced Markers support #7882

aednlaxer · 2024-10-16T11:26:56Z

This PR adds Advanced Markers support to google_maps_flutter as discussed in #155526. The document from the issue offers several options to implement Advanced Markers support, this PR uses option 1 (Advanced Marker Dart class is a subclass Marker class).

Summary of changes:

Add map capability check
Add AdvancedMarker class
Add MarkerCollisionBehavior enum to control Advanced Marker's behavior when it collides with another marker
Add PinConfig bitmap descriptor for customizing Advanced Marker's pin and icon
Add markerType parameter to indicate that Advanced Markers should be used
Rename cloudMapId to mapId

Notes:

native implementations need to know what kind of marker should be used, this is needed to use correct marker options, cluster manager and marker controller. Indicating marker type is done by using a markerType option when creating a GoogleMap (could be marker or advancedMarker). Default option is marker
cloudMapId is deprecated in favor of mapId. New name follows SDKs, documentation and Cloud Console naming.
web implementation uses generics because gmaps.Marker and gmaps.AdvancedMarkerElement are not related to each other and should be handled differently
legacy markers are deprecated but still supported in Maps Javascript API. google_maps_flutter still uses them by default in this PR because of backward-compatibility. #130472 is related, package users will be able to use Advanced Markers to fix the deprecation warning
Advanced Markers example on iOS doesn't show advanced markers, seems to be a known issue
Using Flutter widget as Advanced Marker icon (so called View Marker) is not part of this PR, this was discussed in the document and later removed as we agreed that it should be a separate issue

Resolves #155526

Pre-launch Checklist

If you need help, consider asking for advice on the #hackers-new channel on Discord.

reidbaker

High level android code review. I am concerned by having to runtime type check class.

That said thank you for opening this pull request.

packages/google_maps_flutter/google_maps_flutter/example/android/app/build.gradle

...r_android/android/src/main/java/io/flutter/plugins/googlemaps/ClusterManagersController.java

...flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/GoogleMapController.java

...ps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/GoogleMapFactory.java

...ps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/MarkerController.java

stuartmorgan-g

I've only looked at the app-facing and platform interface packages so far, but there are some fundamental structure questions at the interface layer.

...ages/google_maps_flutter/google_maps_flutter/example/lib/readme_sample_advanced_markers.dart

packages/google_maps_flutter/google_maps_flutter/example/lib/clustering.dart

packages/google_maps_flutter/google_maps_flutter/example/lib/main.dart

packages/google_maps_flutter/google_maps_flutter/example/lib/marker_icons.dart

packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/glyph.dart

...gle_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/map_configuration.dart

...s_flutter/google_maps_flutter_platform_interface/lib/src/types/map_widget_configuration.dart

packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/marker.dart

….com:CodemateLtd/packages into feature/google-maps-advanced-markers-support

packages/google_maps_flutter/google_maps_flutter_web/lib/src/convert.dart

camsim99

Overall, the Android implementation looks good to me! Left some questions regarding testing.

...google_maps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/Convert.java

...le_maps_flutter_android/android/src/test/java/io/flutter/plugins/googlemaps/ConvertTest.java

...ter_android/android/src/test/java/io/flutter/plugins/googlemaps/GoogleMapControllerTest.java

..._maps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/MarkerBuilder.java

camsim99 · 2025-05-28T20:18:39Z

...gle_maps_flutter/google_maps_flutter_android/example/integration_test/google_maps_tests.dart

    skip: true,
  );
+
+  testWidgets('markerWithPinConfig', (WidgetTester tester) async {


Is this testing anything? Can we remove it?

It doesn't explicitly check anything with expect(), it's similar to other marker tests (markerWithLegacyBytes, markerWithAssetMapBitmapCreate etc) which are "run it to make sure it doesn't throw an exception or fail in a different way" kind of tests

vashworth

iOS side LGTM

….com:CodemateLtd/packages into feature/google-maps-advanced-markers-support

camsim99

Android LGTM!

stuartmorgan-g · 2025-07-16T13:28:34Z

@aednlaxer This has high-level LGs for all components now, so please feel free to split out the platform interface PR. I'll re-review that piece here in the meantime, but any comments can be addressed in the sub-PR.

stuartmorgan-g

I re-reviewed the platform interface portion, and everything looks good there :)

…#9737) This PR adds Advanced markers support to the platform interface of `google_maps_flutter`. Approved combined PR: #7882 Issue: [#155526](flutter/flutter#155526) ## Pre-Review Checklist **Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed. [^1]: Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling.

Piinks · 2025-09-22T21:55:36Z

Greetings from stale PR triage! 👋
Is this change still on your radar? It looks like it has had quite the journey and a fair number of stamps, is it ready? :)

stuartmorgan-g · 2025-09-24T13:41:24Z

This is waiting on the sub-PR at #9773

stuartmorgan-g · 2025-10-30T14:11:26Z

@aednlaxer It looks like only web was split out; is there a reason the Android and iOS implementations weren't included in that PR (or a parallel split-out PR)?

jokerttu · 2025-11-02T09:01:03Z

@aednlaxer It looks like only web was split out; is there a reason the Android and iOS implementations weren't included in that PR (or a parallel split-out PR)?

@stuartmorgan-g Discussed with @aednlaxer and I'll take over @aednlaxer 's work, and continue splitting the next PR's.
Already rebased to the main (not pushed yet), and currently fixing issues I found with iOS implementation before creating the PR's. Should be ready soon.

jokerttu · 2025-11-07T14:54:42Z

Created split PR for Android.
I will create split-PR for iOS implementation later as draft as this known issue seems to be still visible.
I have a separate discussion open about this issue, and hopefully, I’ll get a resolution soon.

github-actions bot added p: google_maps_flutter platform-android platform-ios platform-web labels Oct 16, 2024

aednlaxer marked this pull request as ready for review October 21, 2024 07:12

aednlaxer requested review from cbracken, ditman, reidbaker and stuartmorgan-g as code owners October 21, 2024 07:13

reidbaker reviewed Oct 28, 2024

View reviewed changes

stuartmorgan-g added the triage-ios Should be looked at in iOS triage label Nov 21, 2024

stuartmorgan-g requested changes Nov 21, 2024

View reviewed changes

aednlaxer requested review from Hixie, LouiseHsu, Piinks, bparrishMines, camsim99, chunhtai, domesticmouse, gmackall, goderbauer, gspencergoog, hellohuanlin, jmagman, jonahwilliams, loic-sharma, matanlurey, sokoloff06, tarrinneal and yjbanov as code owners December 19, 2024 08:04

aednlaxer added 3 commits May 21, 2025 10:59

Merge branch 'main' into feature/google-maps-advanced-markers-support

cc63ced

Ignore decimal point

f35b350

Merge branch 'feature/google-maps-advanced-markers-support' of github…

28b0072

….com:CodemateLtd/packages into feature/google-maps-advanced-markers-support

ditman reviewed May 22, 2025

View reviewed changes

packages/google_maps_flutter/google_maps_flutter_web/lib/src/convert.dart Outdated Show resolved Hide resolved

aednlaxer added 3 commits May 22, 2025 10:28

Fix num to String conversion of an icon size

a91792c

Merge branch 'main' into feature/google-maps-advanced-markers-support

fc48a9b

Merge branch 'main' into feature/google-maps-advanced-markers-support

14e4778

camsim99 reviewed May 28, 2025

View reviewed changes

vashworth approved these changes Jun 23, 2025

View reviewed changes

This comment was marked as off-topic.

Sign in to view

aednlaxer added 4 commits July 7, 2025 11:13

Remove unused constants

7c547db

Add test for isAdvancedMarkersAvailable (Android)

94d8057

Tweak tests

623fb84

Merge branch 'feature/google-maps-advanced-markers-support' of github…

d3178c0

….com:CodemateLtd/packages into feature/google-maps-advanced-markers-support

gmackall requested a review from camsim99 July 15, 2025 21:15

camsim99 reviewed Jul 16, 2025

View reviewed changes

stuartmorgan-g removed triage-ios Should be looked at in iOS triage triage-android Should be looked at in Android triage labels Jul 16, 2025

stuartmorgan-g reviewed Jul 16, 2025

View reviewed changes

aednlaxer mentioned this pull request Aug 4, 2025

[google_maps_flutter_platform_interface] Add Advanced markers support #9737

Merged

11 tasks

aednlaxer mentioned this pull request Aug 8, 2025

[google_maps_flutter_web] Add Advanced markers support (web) #9773

Open

11 tasks

stuartmorgan-g added the federated: all_changes PR that contains changes for all packages for a federated plugin change label Sep 24, 2025

jokerttu mentioned this pull request Nov 7, 2025

[google_maps_flutter_android] Add advanced markers support #10381

Open

11 tasks

[google_maps_flutter] Add Advanced Markers support #7882

Are you sure you want to change the base?

[google_maps_flutter] Add Advanced Markers support #7882

Uh oh!

Conversation

aednlaxer commented Oct 16, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pre-launch Checklist

Uh oh!

reidbaker left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

stuartmorgan-g left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

camsim99 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

camsim99 May 28, 2025

Choose a reason for hiding this comment

Uh oh!

aednlaxer Jul 14, 2025

Choose a reason for hiding this comment

Uh oh!

vashworth left a comment

Choose a reason for hiding this comment

Uh oh!

This comment was marked as off-topic.

camsim99 left a comment

Choose a reason for hiding this comment

Uh oh!

stuartmorgan-g commented Jul 16, 2025

Uh oh!

stuartmorgan-g left a comment

Choose a reason for hiding this comment

Uh oh!

Piinks commented Sep 22, 2025

Uh oh!

stuartmorgan-g commented Sep 24, 2025

Uh oh!

stuartmorgan-g commented Oct 30, 2025

Uh oh!

jokerttu commented Nov 2, 2025

Uh oh!

jokerttu commented Nov 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

aednlaxer commented Oct 16, 2024 •

edited

Loading

jokerttu commented Nov 7, 2025 •

edited

Loading