https://github.com/ozguronsoy/simplemapview
A Qt widget to display tile maps.
https://github.com/ozguronsoy/simplemapview
c-plus-plus googlemaps map openstreetmap osm qt qt6 tilemap widget
Last synced: 8 months ago
JSON representation
A Qt widget to display tile maps.
- Host: GitHub
- URL: https://github.com/ozguronsoy/simplemapview
- Owner: ozguronsoy
- License: bsd-3-clause
- Created: 2025-01-06T02:13:03.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-04T22:24:37.000Z (10 months ago)
- Last Synced: 2025-05-04T23:29:29.269Z (10 months ago)
- Topics: c-plus-plus, googlemaps, map, openstreetmap, osm, qt, qt6, tilemap, widget
- Language: C++
- Homepage:
- Size: 2.29 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SimpleMapView
A Qt widget for rendering tile maps.
- [Setup](#setup)
- [Map Widget](#map-widget)
- [Create Widget](#create-widget)
- [Change Tile Server](#change-tile-server)
- [Limit Zoom](#limit-zoom)
- [Lock Zoom and Geolocation](#lock-zoom-and-geolocation)
- [Disable Mouse Events](#disable-mouse-events)
- [Map Items](#map-items)
- [Ellipse](#ellipse)
- [Rect](#rect)
- [Text](#text)
- [Image](#image)
- [Lines](#lines)
- [Polygon](#polygon)
- [Markers](#markers)
- [Add Marker](#add-marker)
- [Change Default Marker Icon](#change-default-marker-icon)
## Setup
1. create a folder in your project (e.g., ``dependencies/SimpleMapView``) and copy the repo files to the folder.
2. include ``SimpleMapView`` in your CMake or qmake file.
CMake:
```cmake
set(SIMPLE_MAP_VIEW_ENABLE_RESOURCES ON) # optional
add_subdirectory(dependencies/SimpleMapView)
#include(../dependencies/SimpleMapView/CMakeLists.txt) # if not in a subdirectory
include_directories(dependencies/SimpleMapView/src)
set(PROJECT_SOURCES
# your files
${SIMPLE_MAP_VIEW_SOURCES}
)
target_link_libraries(mytarget PRIVATE
# your libraries
${SIMPLE_MAP_VIEW_LIBRARIES}
)
```
qmake:
```
SIMPLE_MAP_VIEW_ENABLE_RESOURCES = 1
include(dependencies/SimpleMapView/SimpleMapView.pro)
```
## Map Widget
### Create Widget
create the widget inside the main window's constructor, then set the zoom level and the center coordinates to the place you want to display.
```c++
SimpleMapView* mapView = new SimpleMapView(this);
mapView->move(0, 0);
mapView->resize(this->width(), this->height()); // full screen
mapView->setCenter(41.010172, 28.957912); // İstanbul, Türkiye
mapView->setZoomLevel(9);
```
### Change Tile Server
you can use any tile server that contains ``{x}``, ``{y}``, and ``{z}`` coordinates in the URL.
```c++
mapView->setTileServer(SimpleMapView::TileServers::GOOGLE_MAP);
mapView->setTileServer(SimpleMapView::TileServers::GOOGLE_SAT);
mapView->setTileServer("https://a.tile.maptiler.com/{z}/{x}/{y}.png?key=YOUR_API_KEY");
```
### Limit Zoom
you can set limit (min/max) to zoom level.
```c++
mapView->setMinZoomLevel(10);
mapView->setMaxZoomLevel(17);
```
### Lock Zoom and Geolocation
```c++
mapView->lockZoom();
mapView->unlockZoom();
mapView->lockGeolocation();
mapView->unlockGeolocation();
```
### Disable Mouse Events
by default, you can move the map by holding the left mouse button down and moving the mouse. And you can zoom in/out via the mouse wheel.
```c++
mapView->disableMouseWheelZoom();
mapView->enableMouseWheelZoom();
mapView->disableMouseMoveMap();
mapView->enableMouseMoveMap();
```
## Map Items
map items are used for drawing on the map.
All map items are derived from the ``MapItem`` class.
### Ellipse
```c++
MapEllipse* ellipse = new MapEllipse(mapView);
//ellipse->setPosition(QPointF(100, 100));
ellipse->setPosition(mapView->center());
ellipse->setAlignmentFlags(Qt::AlignCenter);
ellipse->setSize(QSizeF(200, 150));
//ellipse->setSize(QGeoCoordinate(1e-3, 2e-3));
ellipse->setBackgroundColor(QColor::fromRgba(0xAF0000FF));
ellipse->setPen(QPen(Qt::black, 3));
```
### Rect
```c++
MapRect* rect = new MapRect(mapView);
rect->setPosition(mapView->center());
rect->setSize(QSizeF(200, 150));
rect->setBorderRadius(8);
rect->setBorderRadius(8, 20, 0, 40);
```
### Text
```c++
MapText* text = new MapText(mapView);
text->setPosition(mapView->center());
// if size is not set
// text size will be used.
text->setText("Lorem ipsum dolor sit amet.");
text->setFont(QFont("Arial", 14));
text->setTextColor(Qt::white);
text->setTextFlags(Qt::TextSingleLine);
text->setTextPadding(10, 10, 10, 10);
```
### Image
```c++
MapImage* img = new MapImage(mapView);
img->setPosition(mapView->center());
img->setAlignmentFlags(Qt::AlignCenter);
img->setBorderRadius(8);
img->setAspectRatioMode(Qt::IgnoreAspectRatio);
img->setImage(QImage("image.png").scaledToWidth(200, Qt::SmoothTransformation));
//img->setImage("image.png");
```
### Lines
```c++
MapLines* lines = new MapLines(mapView);
lines->setPen(QPen(Qt::blue, 5));
lines->points().push_back(QPointF(0, 0));
lines->points().push_back(mapView->center());
```
### Polygon
```c++
MapPolygon* polygon = new MapPolygon(mapView);
polygon->setPen(QPen(Qt::blue, 5));
polygon->setBackgroundColor(QColor(255, 0, 0, 50));
polygon->points() = {
QPointF(-100, 0),
mapView->center(),
QPointF(-100, mapView->height() * 2)
};
```
## Markers
### Add Marker
```c++
MapImage* markerIcon = mapView->addMarker(mapView->center());
markerIcon->findChild()->setText("Marker Text");
```
### Change Default Marker Icon
```c++
mapView->setMarkerIcon(":/map_marker_alt.svg");
QImage newIcon(":/map_marker_alt.svg");
// newIcon.doStuff();
mapView->setMarkerIcon(newIcon);
```