Stay organized with collectionsSave and categorize content based on your preferences.
This example demonstrates how to use custom bitmaps for map markers.
Get started
Before you can try the sample code, you must configure your development environment.
For more information, seeSet up a Flutter project.
View the code
Dart
//Copyright2025GoogleLLC////LicensedundertheApacheLicense,Version2.0(the"License");//youmaynotusethisfileexceptincompliancewiththeLicense.//YoumayobtainacopyoftheLicenseat////https://www.apache.org/licenses/LICENSE-2.0////Unlessrequiredbyapplicablelaworagreedtoinwriting,software//distributedundertheLicenseisdistributedonan"AS IS"BASIS,//WITHOUTWARRANTIESORCONDITIONSOFANYKIND,eitherexpressorimplied.//SeetheLicenseforthespecificlanguagegoverningpermissionsand//limitationsundertheLicense.import'package:flutter/material.dart';import'package:google_maps_flutter/google_maps_flutter.dart';///Showsadvancedoptionsofmarkers.classCustomMarkerSampleextendsStatefulWidget{constCustomMarkerSample({super.key});@overrideState<CustomMarkerSample>createState()=>_CustomMarkerSampleState();}class_CustomMarkerSampleStateextendsState<CustomMarkerSample>{lateMarker_marker=Marker(markerId:MarkerId('my_marker'),//StartwiththedefaultGoogleMapspin,exceptyellow.//(Note:Hueisn't supported on all platforms.)icon:BitmapDescriptor.defaultMarkerWithHue(BitmapDescriptor.hueYellow),onTap:_changeIcon,);@overrideWidgetbuild(BuildContextcontext){returnGoogleMap(initialCameraPosition:CameraPosition(target:LatLng(0,0)),markers:{_marker},);}void_changeIcon()async{//Setuptheimageconfigurationforthenewicon,includingitssize.finalimageConfiguration=createLocalImageConfiguration(context,size:Size(42,52),);//Loadtheiconimagefromanasset.//Alternatively,youcancreatetheiconwithBitmapDescriptor.bytes(),//whichallowsloadingfromnetworkorusingaCustomPainter.finalassetIcon=awaitBitmapDescriptor.asset(imageConfiguration,'assets/icon_flutter.png',);setState((){//Modifytheexistingmarkerwiththenewiconandsetitsanchor//tocenter._marker=_marker.copyWith(iconParam:assetIcon,anchorParam:constOffset(0.5,0.5),);});}}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Add a marker to a map\n\nThis example demonstrates how to use custom bitmaps for map markers.\n\nGet started\n-----------\n\nBefore you can try the sample code, you must configure your development environment.\nFor more information, see [Set up a Flutter project](/maps/flutter-package/config).\n\nView the code\n-------------\n\n### Dart\n\n```python\n// Copyright 2025 Google LLC\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// https://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport 'package:flutter/material.dart';\nimport 'package:google_maps_flutter/google_maps_flutter.dart';\n\n/// Shows advanced options of markers.\nclass CustomMarkerSample extends StatefulWidget {\n const CustomMarkerSample({super.key});\n\n @override\n State\u003cCustomMarkerSample\u003e createState() =\u003e _CustomMarkerSampleState();\n}\n\nclass _CustomMarkerSampleState extends State\u003cCustomMarkerSample\u003e {\n late Marker _marker = Marker(\n markerId: MarkerId('my_marker'),\n // Start with the default Google Maps pin, except yellow.\n // (Note: Hue isn't supported on all platforms.)\n icon: BitmapDescriptor.defaultMarkerWithHue(BitmapDescriptor.hueYellow),\n onTap: _changeIcon,\n );\n\n @override\n Widget build(BuildContext context) {\n return GoogleMap(\n initialCameraPosition: CameraPosition(target: LatLng(0, 0)),\n markers: {_marker},\n );\n }\n\n void _changeIcon() async {\n // Set up the image configuration for the new icon, including its size.\n final imageConfiguration = createLocalImageConfiguration(\n context,\n size: Size(42, 52),\n );\n\n // Load the icon image from an asset.\n // Alternatively, you can create the icon with BitmapDescriptor.bytes(),\n // which allows loading from network or using a CustomPainter.\n final assetIcon = await BitmapDescriptor.asset(\n imageConfiguration,\n 'assets/icon_flutter.png',\n );\n\n setState(() {\n // Modify the existing marker with the new icon and set its anchor\n // to center.\n _marker = _marker.copyWith(\n iconParam: assetIcon,\n anchorParam: const Offset(0.5, 0.5),\n );\n });\n }\n}\nhttps://github.com/googlemaps-samples/flutter-maps-samples/blob/8f227e8b4d07179e5fb7cc5e8d8cb5440befd229/lib/samples/marker_custom.dart\n \n```\n\nNext steps\n----------\n\nView the complete set of samples on GitHub:\n\n[View on GitHub](https://github.com/googlemaps-samples/flutter-maps-samples/tree/main/lib/samples)\n\nAlternatively, clone the full set of samples to run them locally by executing the following commands: \n\n git clone -b flutter_samples https://github.com/googlemaps-samples/flutter-maps-samples.git\n cd flutter-samples\n flutter pub get"]]
