向地图添加标记
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。

此示例演示了如何为地图标记使用自定义位图。
开始使用
您必须先配置开发环境,然后才能试用该示例代码。如需了解详情,请参阅设置 Flutter 项目。
查看代码
Dart
// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
import 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
/// Shows advanced options of markers.
class CustomMarkerSample extends StatefulWidget {
const CustomMarkerSample({super.key});
@override
State<CustomMarkerSample> createState() => _CustomMarkerSampleState();
}
class _CustomMarkerSampleState extends State<CustomMarkerSample> {
late Marker _marker = Marker(
markerId: MarkerId('my_marker'),
// Start with the default Google Maps pin, except yellow.
// (Note: Hue isn't supported on all platforms.)
icon: BitmapDescriptor.defaultMarkerWithHue(BitmapDescriptor.hueYellow),
onTap: _changeIcon,
);
@override
Widget build(BuildContext context) {
return GoogleMap(
initialCameraPosition: CameraPosition(target: LatLng(0, 0)),
markers: {_marker},
);
}
void _changeIcon() async {
// Set up the image configuration for the new icon, including its size.
final imageConfiguration = createLocalImageConfiguration(
context,
size: Size(42, 52),
);
// Load the icon image from an asset.
// Alternatively, you can create the icon with BitmapDescriptor.bytes(),
// which allows loading from network or using a CustomPainter.
final assetIcon = await BitmapDescriptor.asset(
imageConfiguration,
'assets/icon_flutter.png',
);
setState(() {
// Modify the existing marker with the new icon and set its anchor
// to center.
_marker = _marker.copyWith(
iconParam: assetIcon,
anchorParam: const Offset(0.5, 0.5),
);
});
}
}
后续步骤
在 GitHub 上查看完整的示例集:
在 GitHub 上查看
或者,您也可以通过执行以下命令克隆完整的示例集,以便在本地运行这些示例:
git clone -b flutter_samples https://github.com/googlemaps-samples/flutter-maps-samples.git
cd flutter-samples
flutter pub get
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[],[],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"]]