DEV Community

Christopher Coffee
Christopher Coffee

Posted on

Flutter Flow: Adding Custom Markers for Google Maps

Custom markers on Google Maps is one of the highest requested features on Flutter Flow. I’ll walk through how to achieve this using a custom widget.

Setting up custom data types for our markers

First, let’s set up a custom data type to hold information related to Google Map Markers.

Click on the Data Types menu item on the left.

Click on the orange button to Create a Data Type. Let’s use the name GoogleMapData.

Let’s give four fields for our data type.

  • latLng : This will hold our coordinates for each marker

  • iconPath: This will be our image name including the file extension.

  • title: This is the title that shows on the popup when clicking the marker

  • description: This is the description that shows on the popup when clicking the marker

Create our list of markers

To create our list of data, click on the App Values menu.

Click on Add App State Variable

Let’s give it the name googleMapData. **Choose **Data Type as the Data Type. Choose our custom Data Type Google Map Data. Also, make sure to check Is List. **Click **Create

Click the arrow to expand the state variable and you should see Add Item. Notice I already have two items.

Click **Add Item. **I will show you how to add new data.

Notice the data I have for one of my items. You don’t have to enter the coordinates manually. First, copy the name of the place you want to add then click the orange location icon.

In my case, I copied Lucy Ethiopian Restaurant and Bar. It will pop up with a text field to search for your place.

Also, notice I added the name of the icon that I want to show for this place. I will show you how to upload the images after adding these items.

This is the other item I added.

I want to target Little Italy Pizza in Las Vegas, NV but I don’t see it in the list.

It looks like they are using the Google Places API, which I’ve used in a lot of projects.

The trick is if it doesn’t initially show any of the correct places, you can also type the city and/or state after the place name.

Uploading your icons

For simplicity, I’m just using one icon. Adding an icon is straightforward. You can find icons on many sites including Icon Finder and Icons 8.

Use underscores instead of spaces and don’t add any special characters. This is usually an issue that will show up with Android. I’m not sure if Flutter Flow handles it for you on their side.

Click on the Media Assets menu, click Upload Media, and choose your assets.

Creating our custom Google Maps Widget

Click on the Custom Code menu

Click Add > Widget

I gave it the name MapSample.

Now let’s add the following dependencies. Make sure to click the green button after adding all of them.

google_maps_flutter: ^2.5.0
google_maps_flutter_web: ^0.5.2
google_maps_flutter_platform_interface: ^2.4.1
Enter fullscreen mode Exit fullscreen mode

Click Save, then click the compile button (button with a hammer)

Compile Button

Let’s add the parameters for our custom widget. Most of these are the same parameters included in Flutter Flow’s Google Map widget.

Also, notice I have the starting center latitude and longitude as two separate parameters. Part of the workaround is using an alias to reference Flutter Flow’s LatLng type. It throws an error because of a conflict with Google Maps LatLng type.

I’ve also left out the map style. I wanted to do it more elegantly, but a quick way to change it would be to add another custom data type and copy the map that’s used in Flutter Flow’s flutter_flow_google_map.dart file. Let me know if you want an example for that as well.

  • mapData: this is a list data type of our custom data type GoogleMapData

  • allowZoom: Boolean type

  • showZoomControls: Boolean type

  • showLocation: Boolean type

  • showCompass: Boolean type

  • showMapToolbar: Boolean type

  • showTraffic: Boolean type

  • centerLat: Double type. The starting center latitude

  • centerLng: Double type: The starting center longitude.

Click Save.

Next, I will give you the code, but also walk through it, in case you want to add anything later.

Add the following code, click Save, then click the compile button to make sure you don’t get any errors.

// Automatic FlutterFlow imports
import '/backend/schema/structs/index.dart';
import '/flutter_flow/flutter_flow_theme.dart';
import '/flutter_flow/flutter_flow_util.dart';
import '/custom_code/widgets/index.dart'; // Imports other custom widgets
import '/flutter_flow/custom_functions.dart'; // Imports custom functions
import 'package:flutter/material.dart';
// Begin custom widget code

import 'package:google_maps_flutter/google_maps_flutter.dart'
    as google_maps_flutter;
import '/flutter_flow/lat_lng.dart' as latlng;
import 'dart:async';
export 'dart:async' show Completer;
export 'package:google_maps_flutter/google_maps_flutter.dart' hide LatLng;
export '/flutter_flow/lat_lng.dart' show LatLng;

// Set your widget name, define your parameter, and then add the
// boilerplate code using the green button on the right!

class MapSample extends StatefulWidget {
  const MapSample({
    Key? key,
    this.allowZoom = true,
    this.showZoomControls = true,
    this.showLocation = true,
    this.showCompass = false,
    this.showMapToolbar = false,
    this.showTraffic = false,
    this.centerLat = 0.0,
    this.centerLng = 0.0,
  }) : super(key: key);

  final double? width;
  final double? height;
  final List<GoogleMapDataStruct>? mapData;
  final bool allowZoom;
  final bool showZoomControls;
  final bool showLocation;
  final bool showCompass;
  final bool showMapToolbar;
  final bool showTraffic;
  final double centerLat;
  final double centerLng;

  _MapSampleState createState() => _MapSampleState();

class _MapSampleState extends State<MapSample> {
  Completer<google_maps_flutter.GoogleMapController> _controller = Completer();
  Map<String, BitmapDescriptor> _customIcons = {};
  Set<google_maps_flutter.Marker> _markers = {};

  google_maps_flutter.LatLng _center =
      google_maps_flutter.LatLng(36.088110, -115.176468);

  void initState() {

    _center = google_maps_flutter.LatLng(widget.centerLat, widget.centerLng);


  Future<void> _loadMarkerIcons() async {
    Set<String> uniqueIconPaths =
        widget.mapData?.map((data) => data.iconPath).toSet() ??
            {}; // Extract unique icon paths

    for (String path in uniqueIconPaths) {
      if (path.isNotEmpty) {
        google_maps_flutter.BitmapDescriptor descriptor =
            await google_maps_flutter.BitmapDescriptor.fromAssetImage(
          ImageConfiguration(devicePixelRatio: 2.5),
        _customIcons[path] = descriptor;

    _updateMarkers(); // Update markers once icons are loaded

  void _updateMarkers() {
    setState(() {
      _markers = _createMarkers();

  void _onMapCreated(google_maps_flutter.GoogleMapController controller) {

  Widget build(BuildContext context) {
    return Scaffold(
      body: google_maps_flutter.GoogleMap(
        onMapCreated: _onMapCreated,
        zoomGesturesEnabled: widget.allowZoom,
        zoomControlsEnabled: widget.showZoomControls,
        myLocationEnabled: widget.showLocation,
        compassEnabled: widget.showCompass,
        mapToolbarEnabled: widget.showMapToolbar,
        trafficEnabled: widget.showTraffic,
        initialCameraPosition: google_maps_flutter.CameraPosition(
          target: _center,
          zoom: 11.0,
        markers: _markers,

  Set<google_maps_flutter.Marker> _createMarkers() {
    var tmp = <google_maps_flutter.Marker>{};

    // Assuming widget.mapData is a list of objects that contain a 'latLng' property of type latlng.LatLng
    widget.mapData?.forEach((mapData) {
      // Directly use the latlng.LatLng object
      final latlng.LatLng coordinates = mapData.latLng as latlng.LatLng;

      // Convert to google_maps_flutter.LatLng
      final google_maps_flutter.LatLng googleMapsLatLng =
              coordinates.latitude, coordinates.longitude);

      google_maps_flutter.BitmapDescriptor icon =
          customIcons[mapData.iconPath] ??

      // Create and add the marker
      final google_maps_flutter.Marker marker = google_maps_flutter.Marker(
        markerId: google_maps_flutter.MarkerId(mapData.title),
        position: googleMapsLatLng,
        icon: icon,
        infoWindow: google_maps_flutter.InfoWindow(
            title: mapData.title, snippet: mapData.description),


    return tmp;
Enter fullscreen mode Exit fullscreen mode

First, notice the _center variable. I initialized it with the center of Las Vegas, but you can use the center you would use anyway as the parameter.

We reassign it in the initState function using the parameters.

If you don’t have multiple maps in the app, you can remove the parameters and remove the line in initState.

The _loadMarkerIcons function just takes the iconPath name and creates a BitMap Description to use as the Google Marker icon. Maybe iconPath isn’t the best name.

The _createMarkers function goes through our list of mapData and creates the Google Map markers

Add the new Custom Google Map Widget to our page

Go to the Widget Pallete and drag MapSample to your desired page*.*

This is what I used for the properties. Notice I’m using the list we created in the App Values menu, the googleMapData App State Variable.

Save (CMD + S on Mac, Ctrl + S on Windows)

You won’t get any errors initially, but if you try to run this using Test Mode, you will get an error. This is a bug with Flutter Flow’s online platform. If you download the project it will work fine.

Before you download the project though, we have a few more steps.

Create a new page for a Flutter Flow workaround

Flutter Flow won’t add your API keys to your downloaded project unless you have a page that uses their Google Map widget.

As a workaround, I created a page that’s not connected to anything and added their Google Map widget.

They also won’t include your icons, unless you add them to a page as an asset image. This could get ugly if you have a lot of icons, but it may be easier than adding it manually.

This makes sense on Flutter Flow’s part as to why they would do this, maybe we can request something that allows us to choose what to include.

Add the Google Maps API keys

You can follow the Flutter Flow Google Maps API keys.

Another thing to note is that after creating the API keys, while still in the Google Developer Console, click on it and choose the platform you want to use it for, or it may not work correctly.


Download the project and run the app, you should see your custom icons.

Top comments (5)

zackarr profile image

I am unsure of why but When it comes to the 'Add App State' i do not have the option 'Data type' on my list when i click on the Data Type Tab. Am i missing a step or is it not available to all versions of flutterflow (I am up to date but run on the free version.)

benh43 profile image

Is there a way to add locations from firebase? I have locations that change depending on the day, and it would be nice if they could be automatically loaded.

bzimbler profile image

Hey, I am trying to run this example on web app.
As you said, it wont work on test mode. But when I deploy it , it still won't work.
Is there any way to make it work online?

vishwak_63 profile image
Vishwa Kiran

I am assuming an onTap handler can be created to place markers on the map ?

chrisr profile image
Chris • Edited

I have been searching for this for a while, so thank you!

Is there a way to add a custom function/action in FlutterFlow to add a custom map style json without having to create a custom widget?