Класс MfwMap

Класс MfwMap предоставляет элемент Qt Quick для отображения и взаимодействия с картой. Подробнее…

Подключение:	#include <MfwMap>
Наследники:	MfwOfflineMap

• Список всех членов класса, включая унаследованные

Публичные типы

enum	CacheMode
enum	LangIsoCode
enum	MapError
enum	MapMode

Свойства

• accessToken : QString
• apiBaseUrl : QString
• apiKey : QString
• assetPath : QString
• bearing : qreal
• bearingEnabled : bool
• cacheDatabaseDefaultPath : bool
• cacheDatabaseMaximalSize : int
• cacheDatabasePath : QString
• cacheDatabaseStoreSettings : bool
• cacheMode : CacheMode
• center : QGeoCoordinate
• clickSize : qreal
• devicePixelRatio : qreal
• doubleClickDelay : qreal
• doubleClickLengthDelta : qreal
• errorString : const QString
• gestureInProgress : bool
• langIsoCode : LangIsoCode
• mapObjects : const QVariantMap
• mapToQtPixelRatio : const qreal
• margins : QRectF
• maximumZoomLevel : qreal
• metersPerMapPixel : const qreal
• metersPerPixel : const qreal
• metersPerPixelTolerance : qreal
• minimumZoomLevel : qreal
• mode : MapMode
• panFactor : qreal
• pinchFactor : qreal
• pitch : qreal
• pixelRatio : qreal
• rotateFactor : qreal
• rotationSensitivity : qreal
• showUserLocation : bool
• styleJson : QString
• styleUrl : QString
• tapAndHoldDelay : qreal
• urlDebug : bool
• urlSuffix : QString
• useFramebuffer : bool
• userDirection : qreal
• userLocation : QGeoCoordinate
• userLocationAccuracy : qreal
• userMarker : QVariantMap
• zoomLevel : qreal

Публичные функции

	MfwMap(QQuickItem *parent = nullptr)
	~MfwMap()
void	addImage(const QString &name, const QImage &sprite)
bool	addImagePath(const QString &name, const QString &path, const int svgX = 0, const int svgY = 0)
void	addLayer(const QString &id, const QVariantMap &params, const QString &before = QString())
void	addMapObject(MfwMapObject *mapObject)
void	addSource(const QString &sourceID, const QVariantMap &params)
void	addSourceLine(const QString &sourceID, const QVariantList &coordinates, const QString &name = QString())
void	addSourcePoint(const QString &sourceID, const QGeoCoordinate &coordinate, const QString &name = QString())
void	addSourcePoint(const QString &sourceID, qreal latitude, qreal longitude, const QString &name = QString())
void	addSourcePoints(const QString &sourceID, const QVariantList &coordinates, const QVariantList &names = QVariantList())
void	alignViewToCoordinates(QGeoCoordinate sw, QGeoCoordinate ne)
void	clearCache()
void	clearMapObjects()
QVariantList	defaultStyles() const
void	findMapObject(QGeoCoordinate diagonalCoordinate1, QGeoCoordinate diagonalCoordinate2, const QVariant &tag = QVariant())
void	fitView(const QVariantList &coordinates, bool preserve = false)
QString	getAccessToken() const
QString	getApiBaseUrl() const
QString	getApiKey() const
QString	getAssetPath() const
qreal	getBearing() const
bool	getBearingEnabled() const
bool	getCacheDatabaseDefaultPath() const
int	getCacheDatabaseMaximalSize() const
QString	getCacheDatabasePath() const
bool	getCacheDatabaseStoreSettings() const
CacheMode	getCacheMode() const
QGeoCoordinate	getCenter() const
qreal	getClickSize() const
qreal	getDevicePixelRatio() const
qreal	getDoubleClickDelay() const
qreal	getDoubleClickLengthDelta() const
QString	getErrorString() const
bool	getGestureInProgress() const
LangIsoCode	getLangIsoCode() const
QVariantMap	getMapObjects() const
qreal	getMapToQtPixelRatio() const
QRectF	getMargins() const
qreal	getMaximumZoomLevel() const
qreal	getMetersPerMapPixel() const
qreal	getMetersPerPixel() const
qreal	getMetersPerPixelTolerance() const
qreal	getMinimumZoomLevel() const
MapMode	getMode() const
qreal	getPanFactor() const
qreal	getPinchFactor() const
qreal	getPitch() const
qreal	getPixelRatio() const
qreal	getRotateFactor() const
qreal	getRotationSensitivity() const
bool	getShowUserLocation() const
QString	getStyleJson() const
QString	getStyleUrl() const
qreal	getTapAndHoldDelay() const
bool	getUrlDebug() const
QString	getUrlSuffix() const
bool	getUseFramebuffer() const
qreal	getUserDirection() const
QGeoCoordinate	getUserLocation() const
qreal	getUserLocationAccuracy() const
QVariantMap	getUserMarker() const
qreal	getZoomLevel() const
void	pan(int dx, int dy)
void	removeAllLocationTracking()
void	removeImage(const QString &name)
void	removeLayer(const QString &id)
void	removeLocationTracking(const QString &id)
void	removeMapObject(MfwMapObject *item)
void	removeSource(const QString &sourceID)
void	setAccessToken(const QString &token)
void	setApiBaseUrl(const QString &url)
void	setApiKey(QString apiKey)
void	setAssetPath(const QString &path)
void	setBearing(qreal b)
void	setBearingEnabled(bool bearingEnabled)
void	setCacheDatabaseDefaultPath(bool s)
void	setCacheDatabaseMaximalSize(int sz)
void	setCacheDatabasePath(const QString &path)
void	setCacheDatabaseStoreSettings(bool s)
void	setCacheMode(CacheMode cacheMode)
void	setClickSize(qreal clickSize)
void	setDevicePixelRatio(qreal devicePixelRatio)
void	setDoubleClickDelay(qreal doubleClickDelay)
void	setDoubleClickLengthDelta(qreal doubleClickLengthDelta)
void	setGestureInProgress(bool progress)
void	setLangIsoCode(LangIsoCode langIsoCode)
void	setLayoutProperty(const QString &layer, const QString &property, const QVariant &value)
void	setLayoutPropertyList(const QString &layer, const QString &property, const QVariantList &value)
void	setMargins(qreal left, qreal top, qreal right, qreal bottom)
void	setMargins(const QRectF &margins_box)
void	setMaximumZoomLevel(qreal maximumZoomLevel)
void	setMetersPerPixelTolerance(qreal tol)
void	setMinimumZoomLevel(qreal minimumZoomLevel)
void	setMode(MapMode mapMode)
void	setPaintProperty(const QString &layer, const QString &property, const QVariant &value)
void	setPaintPropertyList(const QString &layer, const QString &property, const QVariantList &value)
void	setPanFactor(qreal panFactor)
void	setPinchFactor(qreal pinchFactor)
void	setPitch(qreal p)
void	setPixelRatio(qreal pixelRatio)
void	setRotateFactor(qreal rotateFactor)
void	setRotationSensitivity(qreal rotationSensitivity)
void	setShowUserLocation(bool showUserLocation)
void	setStyleJson(const QString &json)
void	setStyleUrl(const QString &url)
void	setTapAndHoldDelay(qreal tapAndHoldDelay)
void	setUrlDebug(bool debug)
void	setUrlSuffix(const QString &urlsfx)
void	setUseFramebuffer(bool fbo)
void	setUserDirection(qreal userDirection)
void	setUserLocation(QGeoCoordinate userLocation)
void	setUserLocationAccuracy(qreal userLocationAccuracy)
void	setUserMarker(QVariantMap userMarker)
void	setZoomLevel(qreal zoomLevel, const QPointF &center = QPointF())
void	stopFitView()
void	tapTriggered(QTouchEvent *event)
void	trackLocation(const QString &id, const QGeoCoordinate &location)
void	updateSource(const QString &sourceID, const QVariantMap &params)
void	updateSourceLine(const QString &sourceID, const QVariantList &coordinates, const QString &name = QString())
void	updateSourcePoint(const QString &sourceID, const QGeoCoordinate &coordinate, const QString &name = QString())
void	updateSourcePoint(const QString &sourceID, qreal latitude, qreal longitude, const QString &name = QString())
void	updateSourcePoints(const QString &sourceID, const QVariantList &coordinates, const QVariantList &names = QVariantList())

Публичные слоты

void	replyRTreeBoxChanged(box oldRTreeBox, box rTreeBox, MfwMapObject *obj)
void	setCenter(const QGeoCoordinate &coordinate)

Сигналы

void	accessTokenChanged(QString token)
void	apiBaseUrlChanged(QString url)
void	apiKeyChanged(QString apiKey)
void	assetPathChanged(QString path)
void	bearingChanged(qreal bearing)
void	bearingEnabledChanged(bool bearingEnabled)
void	cacheDatabaseAppNameChanged(QString name)
void	cacheDatabaseDefaultPathChanged(bool defaultpath)
void	cacheDatabaseMaximalSizeChanged(int size)
void	cacheDatabasePathChanged(QString path)
void	cacheDatabaseStoreSettingsChanged(bool storesettings)
void	cacheModeChanged(CacheMode cacheMode)
void	centerChanged(const QGeoCoordinate &coordinate)
void	clickSizeChanged(qreal clickSize)
void	clicked(QPointF coordinate, QPoint point)
void	devicePixelRatioChanged(qreal devicePixelRatio)
void	doubleClickDelayChanged(qreal doubleClickDelay)
void	doubleClickLengthDeltaChanged(qreal doubleClickLengthDelta)
void	error(MapError code, QString message)
void	errorChanged(QString error)
void	gestureInProgressChanged(bool gestureInProgress)
void	langIsoCodeChanged(LangIsoCode langIsoCode)
void	locationChanged(QString id, bool visible, const QPoint pixel)
void	locationTrackingRemoved(QString id)
void	logoClicked()
void	longPressed(QGeoCoordinate coordinate, QGeoCoordinate point)
void	mapObjectAdded(MfwMapObject *mapObject)
void	mapObjectClicked(QString id, QGeoCoordinate coordinate)
void	mapObjectRemoved(MfwMapObject *item)
void	mapObjectsChanged(QVariantMap mapObject)
void	mapToQtPixelRatioChanged(qreal mapToQtPixelRatio)
void	marginsChanged(const QMarginsF &margins)
void	maximumZoomLevelChanged()
void	metersPerPixelChanged(qreal metersPerPixel)
void	metersPerPixelToleranceChanged(qreal metersPerPixelTolerance)
void	minimumZoomLevelChanged()
void	modeChanged(MapMode mapMode)
void	objectClicked(MfwMapObject *object, QGeoCoordinate coordinate, QGeoCoordinate point)
void	panFactorChanged(qreal panFactor)
void	pinchFactorChanged(qreal pinchFactor)
void	pitchChanged(qreal pitch)
void	pixelRatioChanged(qreal pixelRatio)
void	queryCoordinateForPixel(const QPointF p, const QVariant &tag = QVariant())
void	queryCoordinateToFindMapObject(QPointF p, float radius, const QVariant &tag = QVariant())
void	queryCoordinateZoomForBounds(QGeoCoordinate sw, QGeoCoordinate ne)
void	queryLayerExists(const QString id)
void	queryPixelForCoordinate(double lat, double lng, const QVariant &tag = QVariant())
void	querySourceExists(const QString id)
void	replyCoordinateForPixel(const QPointF pixel, QGeoCoordinate geocoordinate, qreal degLatPerPixel, qreal degLonPerPixel, const QVariant &tag = QVariant())
void	replyLayerExists(const QString id, bool exists)
void	replyPixelForCoordinate(QPointF screenPoint, const QVariant &tag = QVariant())
void	replySourceExists(const QString id, bool exists)
void	rotateFactorChanged(qreal rotateFactor)
void	rotationSensitivityChanged(qreal rotationSensitivity)
void	showUserLocationChanged(bool showUserLocation)
void	startRefreshTimer()
void	stopRefreshTimer()
void	styleJsonChanged(QString json)
void	styleUrlChanged(QString url)
void	tapAndHoldDelayChanged(qreal tapAndHoldDelay)
void	urlDebugChanged(bool urlDebug)
void	urlSuffixChanged(QString urlSuffix)
void	useFramebufferChanged(bool useFramebuffer)
void	userDirectionChanged(qreal userDirection)
void	userLocationAccuracyChanged(qreal userLocationAccuracy)
void	userLocationChanged(QGeoCoordinate userLocation)
void	userMarkerChanged(QVariantMap userMarker)
void	zoomLevelChanged(qreal zoomLevel)

Защищённые методы

QString

getLangIsoCodeString(LangIsoCode langIsoCode)

Подробное описание

Класс MfwMap предоставляет элемент Qt Quick для отображения и взаимодействия с картой.

Этот класс объединяет такой функционал карты, как панорамирование, масштабирование и добавление различных объектов карты. Он построен на основе QMapLibreGL и расширяет QQuickItem.

Описание типов-членов

enum MfwMap::CacheMode

Перечисляет режимы кэширования данных карты.

Это перечисление определяет, как данные карты, такие как тайлы, кэшируются, что влияет на производительность и использование памяти.

Константа	Значение	Описание
MfwMap::Memory	0	Кэширование осуществляется в памяти, обеспечивая более быстрый доступ за счет более высокого использования памяти.
MfwMap::Storage	1<<0	Кэширование осуществляется в локальном хранилище, что позволяет сохранять кэш на протяжении всех сессий.

enum MfwMap::LangIsoCode

Перечисляет поддерживаемые языковые ISO-коды для меток карт.

В этом перечне cодержатся коды ISO для различных языков. Эти коды можно использовать для установки языка для меток карты и других текстовых элементов на карте.

Константа	Значение	Описание
MfwMap::Arabic	0	Представляет собой арабский язык.
MfwMap::English	1<<0	Представляет собой английский язык.
MfwMap::Spanish	2<<0	Представляет собой испанский язык.
MfwMap::French	3<<0	Представляет собой французский язык.
MfwMap::German	4<<0	Представляет собой немецкий язык.
MfwMap::Italian	5<<0	Представляет собой итальянский язык.
MfwMap::Portuguese	6<<0	Представляет собой португальский язык.
MfwMap::Russian	7<<0	Представляет собой русский язык.
MfwMap::SimplifiedChinese	8<<0	Представляет собой упрощенный китайский язык.
MfwMap::TraditionalChinese	9<<0	Представляет собой традиционный китайский язык.
MfwMap::Japanese	10<<0	Представляет собой японский язык.
MfwMap::Korean	11<<0	Представляет собой корейский язык.
MfwMap::Vietnamese	12<<0	Представляет собой вьетнамский язык.

enum MfwMap::MapError

Перечисляет коды ошибок, с которыми может столкнуться карта.

Это перечисление определяет различные типы ошибок, которые могут возникнуть в компоненте карты.

Константа	Значение	Описание
MfwMap::Zero	0	Ошибка не произошла.
MfwMap::CodeOne	1<<0	Представляет собой конкретный тип ошибки.
MfwMap::CodeTwo	1<<1	Представляет собой другой конкретный тип ошибки.
MfwMap::CodeThree	1<<2	Представляет собой еще один конкретный тип ошибок.

enum MfwMap::MapMode

Перечисляет режимы работы карты.

Это перечисление определяет режим, в котором работает карта, влияя на ее поведение и рендеринг.

Константа	Значение	Описание
MfwMap::Continuous	0	Карта работает в непрерывном режиме, обеспечивая динамическое взаимодействие, например, панорамирование и масштабирование.
MfwMap::Static	1<<0	Карта работает в статическом режиме, подходящем для создания моментальных снимков карты без интерактивных функций.

Описание свойств

accessToken : QString

Это свойство содержит токен доступа, используемый для аутентифицированных служб и источников данных.

AccessToken необходим для доступа к некоторым картографическим службам и источникам данных, требующим аутентификации. Обычно он предоставляется поставщиком картографических услуг и должен быть настроен на доступ к ограниченному или премиальному контенту.

Функции доступа:

QString	getAccessToken() const
void	setAccessToken(const QString &token)

Сигнал уведомления:

void	accessTokenChanged(QString token)

apiBaseUrl : QString

Это свойство содержит базовый URL-адрес для API-запросов карты.

apiBaseUrl — это строка, определяющая базовый URL для всех API-запросов, выполняемых картой. Они могут включать запросы на тайлы, стили и другие данные, связанные с картой.

Функции доступа:

QString	getApiBaseUrl() const
void	setApiBaseUrl(const QString &url)

Сигнал уведомления:

void	apiBaseUrlChanged(QString url)

apiKey : QString

Это свойство содержит ключ API для картографических сервисов.

Ключ apiKey — это QString, используемый для аутентификации запросов к поставщику картографических услуг.

Функции доступа:

QString	getApiKey() const
void	setApiKey(QString apiKey)

Сигнал уведомления:

void	apiKeyChanged(QString apiKey)

assetPath : QString

Это свойство указывает путь к файлу с ресурсами карты.

assetPath — это строка, представляющая путь к локальной файловой системе, где расположены ресурсы карты, такие как таблицы стилей и иконки.

Функции доступа:

QString	getAssetPath() const
void	setAssetPath(const QString &path)

Сигнал уведомления:

void	assetPathChanged(QString path)

bearing : qreal

Это свойство содержит угол пеленга карты в градусах.

Пеленг — это направленный угол карты, измеряемый в градусах по часовой стрелке относительно севера. Он определяет поворот карты. Значение по умолчанию равно 0, что означает север.

Функции доступа:

qreal	getBearing() const
void	setBearing(qreal b)

Сигнал уведомления:

void	bearingChanged(qreal bearing)

bearingEnabled : bool

Это свойство включает или отключает функцию пеленгации на карте.

bearingEnabled — это логическое значение, которое включает или выключает способность карты отображать и изменять пеленг или направление.

Функции доступа:

bool	getBearingEnabled() const
void	setBearingEnabled(bool bearingEnabled)

Сигнал уведомления:

void	bearingEnabledChanged(bool bearingEnabled)

cacheDatabaseDefaultPath : bool

Это свойство указывает, используется ли путь по умолчанию для базы данных кэша карты.

Если установлено значение true, карта использует путь по умолчанию для хранения базы данных кэша. Если false, то пользовательский путь может быть задан с помощью свойства cachePath.

Функции доступа:

bool	getCacheDatabaseDefaultPath() const
void	setCacheDatabaseDefaultPath(bool s)

Сигнал уведомления:

void	cacheDatabaseDefaultPathChanged(bool defaultpath)

cacheDatabaseMaximalSize : int

Это свойство устанавливает максимальный размер базы данных кэша карты.

cacheDatabaseMaximalSize — это целое число, определяющее максимальный размер в байтах локальной базы данных кэша.

Функции доступа:

int	getCacheDatabaseMaximalSize() const
void	setCacheDatabaseMaximalSize(int sz)

Сигнал уведомления:

void	cacheDatabaseMaximalSizeChanged(int size)

cacheDatabasePath : QString

Это свойство определяет путь к базе данных кэша карты.

cacheDatabasePath — это QString, указывающая путь к файловой системе локальной базы данных кэша карты.

Функции доступа:

QString	getCacheDatabasePath() const
void	setCacheDatabasePath(const QString &path)

Сигнал уведомления:

void	cacheDatabasePathChanged(QString path)

cacheDatabaseStoreSettings : bool

Это свойство указывает, сохраняются ли настройки базы данных кэша карты на постоянной основе.

Если установлено значение true, настройки, связанные с базой данных кэша карты, хранятся постоянно, что позволяет использовать их в разных сессиях.

Функции доступа:

bool	getCacheDatabaseStoreSettings() const
void	setCacheDatabaseStoreSettings(bool s)

Сигнал уведомления:

void	cacheDatabaseStoreSettingsChanged(bool storesettings)

cacheMode : CacheMode

Это свойство определяет режим кэширования карты.

Свойство cacheMode представляет собой перечисление, определяющее способ кэширования данных карты, что влияет на производительность и использование данных.

Функции доступа:

CacheMode	getCacheMode() const
void	setCacheMode(CacheMode cacheMode)

Сигнал уведомления:

void	cacheModeChanged(CacheMode cacheMode)

center : QGeoCoordinate

Это свойство содержит географическую координату в центре карты.

Центр представлен в виде QGeoCoordinate. Изменение этого свойства приведет к изменению ориентации карты на указанные координаты.

Функции доступа:

QGeoCoordinate	getCenter() const
void	setCenter(const QGeoCoordinate &coordinate)

Сигнал уведомления:

void	centerChanged(const QGeoCoordinate &coordinate)

clickSize : qreal

Это свойство устанавливает порог размера для взаимодействия по клику.

clickSize — это qreal, определяющий размер в пикселях, используемый для обнаружения взаимодействия с кликом на карте.

Функции доступа:

qreal	getClickSize() const
void	setClickSize(qreal clickSize)

Сигнал уведомления:

void	clickSizeChanged(qreal clickSize)

devicePixelRatio : qreal

Это свойство содержит соотношение пикселей устройства, используемое для рендеринга карты.

Параметр devicePixelRatio влияет на масштабирование и рендеринг элементов карты, особенно в средах с высокой плотностью отображения. Он представляет собой соотношение между физическими пикселями и пикселями, не зависящими от устройства.

Функции доступа:

qreal	getDevicePixelRatio() const
void	setDevicePixelRatio(qreal devicePixelRatio)

Сигнал уведомления:

void	devicePixelRatioChanged(qreal devicePixelRatio)

doubleClickDelay : qreal

Это свойство задаёт максимальную задержку между нажатиями для события двойного нажатия.

DoubleClickDelay — это qreal-значение, которое определяет временной интервал в миллисекундах, чтобы отличить двойной щелчок от двух одинарных щелчков.

Функции доступа:

qreal	getDoubleClickDelay() const
void	setDoubleClickDelay(qreal doubleClickDelay)

Сигнал уведомления:

void	doubleClickDelayChanged(qreal doubleClickDelay)

doubleClickLengthDelta : qreal

Это свойство определяет максимальное расстояние между щелчками в событии двойного щелчка.

DoubleClickLengthDelta — это qreal, определяющий максимальное расстояние в пикселях между двумя нажатиями, которое должно считаться двойным нажатием.

Функции доступа:

qreal	getDoubleClickLengthDelta() const
void	setDoubleClickLengthDelta(qreal doubleClickLengthDelta)

Сигнал уведомления:

void	doubleClickLengthDeltaChanged(qreal doubleClickLengthDelta)

errorString : const QString

В этом свойстве хранится последнее сообщение об ошибке.

Свойство errorString предоставляет информацию о последней ошибке, произошедшей в компоненте карты, например, о неудачных сетевых запросах или проблемах с рендерингом.

Функции доступа:

QString

getErrorString() const

Сигнал уведомления:

void	errorChanged(QString error)

gestureInProgress : bool

Это свойство указывает, выполняется ли в данный момент на карте взаимодействие с помощью жестов.

Если установлено значение true, это означает, что пользовательский жест, такой как сжатие или перетаскивание, активно манипулирует видом карты. Это может использоваться для управления взаимодействием и обновлениями во время операций с жестами.

Функции доступа:

bool	getGestureInProgress() const
void	setGestureInProgress(bool progress)

Сигнал уведомления:

void	gestureInProgressChanged(bool gestureInProgress)

langIsoCode : LangIsoCode

Это свойство определяет код языка, используемый для меток и текста карты.

langIsoCode — это перечисление, представляющее коды языков ISO, которые используются для установки языка для меток карт и другого текста.

Функции доступа:

LangIsoCode	getLangIsoCode() const
void	setLangIsoCode(LangIsoCode langIsoCode)

Сигнал уведомления:

void	langIsoCodeChanged(LangIsoCode langIsoCode)

mapObjects : const QVariantMap

Это свойство обеспечивает доступ к объектам карты.

mapObjects — это QVariantMap, содержащий ссылки на объекты карты, находящиеся в данный момент на карте.

Функции доступа:

QVariantMap

getMapObjects() const

Сигнал уведомления:

void	mapObjectsChanged(QVariantMap mapObject)

mapToQtPixelRatio : const qreal

Это свойство содержит отношение пикселей карты к пикселям Qt, не зависящим от устройства.

Функция mapToQtPixelRatio используется для преобразования координат и размеров между внутренними единицами пикселей карты и логическими единицами пикселей Qt, обеспечивая правильное масштабирование и позиционирование элементов карты в среде Qt.

Функции доступа:

qreal

getMapToQtPixelRatio() const

Сигнал уведомления:

void	mapToQtPixelRatioChanged(qreal mapToQtPixelRatio)

margins : QRectF

Это свойство задаёт поля вокруг области просмотра карты.

Свойство margins представляет собой QRectF, который определяет границы вокруг области просмотра карты, влияя на видимую область карты.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.getMargins();
        }
    }
}

Функции доступа:

QRectF	getMargins() const
void	setMargins(qreal left, qreal top, qreal right, qreal bottom)
void	setMargins(const QRectF &margins_box)

Сигнал уведомления:

void	marginsChanged(const QMarginsF &margins)

maximumZoomLevel : qreal

Это свойство определяет максимальный уровень масштабирования карты.

MaximumZoomLevel — это qreal-значение, задающее максимально возможный уровень масштабирования карты. Он ограничивает приближение карты к пользователю.

Функции доступа:

qreal	getMaximumZoomLevel() const
void	setMaximumZoomLevel(qreal maximumZoomLevel)

Сигнал уведомления:

void	maximumZoomLevelChanged()

metersPerMapPixel : const qreal

Это свойство содержит количество метров, которое представляет каждый пиксель карты, независимо от соотношения пикселей устройства.

Аналогично metersPerPixel, но это значение корректируется с учетом соотношения пикселей устройства, обеспечивая последовательное измерение для различных устройств и плотностей дисплеев.

Функции доступа:

qreal

getMetersPerMapPixel() const

Сигнал уведомления:

void	metersPerPixelChanged(qreal metersPerPixel)

metersPerPixel : const qreal

Это свойство содержит количество метров, которое представляет каждый пиксель при текущем уровне масштабирования и центре.

Свойство metersPerPixel позволяет определить масштаб карты. Он показывает реальное расстояние, занятое одним пикселем на карте при текущем уровне масштабирования и центральной координате.

Функции доступа:

qreal

getMetersPerPixel() const

Сигнал уведомления:

void	metersPerPixelChanged(qreal metersPerPixel)

metersPerPixelTolerance : qreal

Это свойство задаёт уровень допуска, используемый в расчетах metersPerPixel.

Свойство metersPerPixelTolerance используется для определения уровня точности вычисления значения metersPerPixel. Меньшее значение допуска обеспечивает более точные измерения, но может потребовать более частого обновления при панорамировании или масштабировании карты.

Функции доступа:

qreal	getMetersPerPixelTolerance() const
void	setMetersPerPixelTolerance(qreal tol)

Сигнал уведомления:

void	metersPerPixelToleranceChanged(qreal metersPerPixelTolerance)

minimumZoomLevel : qreal

Это свойство определяет минимальный уровень масштабирования карты.

MinimumZoomLevel — это qreal-значение, определяющее минимально возможный уровень масштабирования карты. Он ограничивает масштаб изображения.

Функции доступа:

qreal	getMinimumZoomLevel() const
void	setMinimumZoomLevel(qreal minimumZoomLevel)

Сигнал уведомления:

void	minimumZoomLevelChanged()

mode : MapMode

Это свойство определяет режим работы карты.

Свойство mode определяет поведение и отображение карты. Он может быть настроен на различные режимы, например, стандартный режим для интерактивных карт или статический режим для неинтерактивных карт в стиле моментальных снимков.

Функции доступа:

MapMode	getMode() const
void	setMode(MapMode mapMode)

Сигнал уведомления:

void	modeChanged(MapMode mapMode)

panFactor : qreal

Это свойство определяет чувствительность жеста панорамирования карты.

panFactor — это qreal-значение, которое регулирует отзывчивость карты на жесты панорамирования, управляя тем, как карта перемещается при перетаскивании.

Функции доступа:

qreal	getPanFactor() const
void	setPanFactor(qreal panFactor)

Сигнал уведомления:

void	panFactorChanged(qreal panFactor)

pinchFactor : qreal

Это свойство определяет чувствительность жеста сжатия.

PinchFactor — это qreal-значение, которое влияет на отзывчивость карты на жесты сжатия, управляющие изменением уровня масштабирования.

Функции доступа:

qreal	getPinchFactor() const
void	setPinchFactor(qreal pinchFactor)

Сигнал уведомления:

void	pinchFactorChanged(qreal pinchFactor)

pitch : qreal

Это свойство содержит угол наклона карты в градусах.

Угол наклона определяет угол, под которым просматривается карта. При угле наклона 0 градусов получается двухмерный вид карты сверху вниз, в то время как более высокие значения наклоняют вид к горизонту, создавая трехмерную перспективу.

Функции доступа:

qreal	getPitch() const
void	setPitch(qreal p)

Сигнал уведомления:

void	pitchChanged(qreal pitch)

pixelRatio : qreal

Это свойство содержит соотношение пикселей, используемое для рендеринга элементов карты.

Параметр pixelRatio используется для масштабирования элементов и слоев карты. Он может отличаться от devicePixelRatio, что позволяет лучше контролировать процесс рендеринга.

Функции доступа:

qreal	getPixelRatio() const
void	setPixelRatio(qreal pixelRatio)

Сигнал уведомления:

void	pixelRatioChanged(qreal pixelRatio)

rotateFactor : qreal

Это свойство задаёт чувствительность жеста вращения.

rotateFactor — это qreal-значение, которое регулирует отзывчивость карты на жесты вращения, управляя поворотом карты.

Функции доступа:

qreal	getRotateFactor() const
void	setRotateFactor(qreal rotateFactor)

Сигнал уведомления:

void	rotateFactorChanged(qreal rotateFactor)

rotationSensitivity : qreal

Это свойство задаёт чувствительность жеста вращения.

rotationSensitivity — это qreal-значение, которое регулирует чувствительность карты к жестам вращения, влияя на то, насколько легко карта поворачивается.

Функции доступа:

qreal	getRotationSensitivity() const
void	setRotationSensitivity(qreal rotationSensitivity)

Сигнал уведомления:

void	rotationSensitivityChanged(qreal rotationSensitivity)

showUserLocation : bool

Это свойство указывает, отображается ли местоположение пользователя на карте.

Если установить значение true, на карте будет отображаться текущее местоположение пользователя. Эта функция требует соответствующих разрешений для доступа к службам определения местоположения.

Функции доступа:

bool	getShowUserLocation() const
void	setShowUserLocation(bool showUserLocation)

Сигнал уведомления:

void	showUserLocationChanged(bool showUserLocation)

styleJson : QString

Это свойство содержит строку JSON, определяющую стиль карты.

styleJson — это QString, содержащий JSON-представление настроек стиля карты.

Функции доступа:

QString	getStyleJson() const
void	setStyleJson(const QString &json)

Сигнал уведомления:

void	styleJsonChanged(QString json)

styleUrl : QString

Это свойство указывает URL-адрес стиля карты.

styleUrl — это QString, указывающий на URL, где определен стиль карты.

Функции доступа:

QString	getStyleUrl() const
void	setStyleUrl(const QString &url)

tapAndHoldDelay : qreal

Это свойство устанавливает задержку для распознавания жеста касания и удержания.

Задержка касания (tapAndHoldDelay) — это qreal-значение, определяющее продолжительность в миллисекундах, в течение которой необходимо удерживать касание, чтобы вызвать событие касания и удержания.

Функции доступа:

qreal	getTapAndHoldDelay() const
void	setTapAndHoldDelay(qreal tapAndHoldDelay)

Сигнал уведомления:

void	tapAndHoldDelayChanged(qreal tapAndHoldDelay)

urlDebug : bool

Это свойство включает или отключает ведение журнала отладки для запросов URL.

Если urlDebug имеет значение true, в журнал записывается дополнительная отладочная информация о сетевых запросах, выполняемых картой, что помогает при отладке проблем, связанных с сетью.

Функции доступа:

bool	getUrlDebug() const
void	setUrlDebug(bool debug)

Сигнал уведомления:

void	urlDebugChanged(bool urlDebug)

urlSuffix : QString

Это свойство содержит суффикс, добавляемый к запросам, выполняемым картой.

urlSuffix можно использовать для добавления пользовательских параметров или идентификаторов ко всем сетевым запросам, выполняемым картой, например, к запросам тайлов или стиля.

Функции доступа:

QString	getUrlSuffix() const
void	setUrlSuffix(const QString &urlsfx)

Сигнал уведомления:

void	urlSuffixChanged(QString urlSuffix)

useFramebuffer : bool

Это свойство определяет, использует ли карта фреймбуфер для рендеринга.

Если установлено значение true, карта перед отображением выводится за пределы экрана в объект framebuffer. Это может улучшить производительность и качество рендеринга в определенных сценариях.

Функции доступа:

bool	getUseFramebuffer() const
void	setUseFramebuffer(bool fbo)

Сигнал уведомления:

void	useFramebufferChanged(bool useFramebuffer)

userDirection : qreal

Это свойство отображает направление пользователя на карте.

UserDirection — qreal, представляющий направление или пеленг пользователя на карте, обычно в градусах.

Функции доступа:

qreal	getUserDirection() const
void	setUserDirection(qreal userDirection)

Сигнал уведомления:

void	userDirectionChanged(qreal userDirection)

userLocation : QGeoCoordinate

Это свойство содержит географические координаты местоположения пользователя.

Свойство userLocation — это QGeoCoordinate, представляющая текущее местоположение пользователя. Это свойство используется вместе со свойством showUserLocation для отображения местоположения на карте.

Функции доступа:

QGeoCoordinate	getUserLocation() const
void	setUserLocation(QGeoCoordinate userLocation)

Сигнал уведомления:

void	userLocationChanged(QGeoCoordinate userLocation)

userLocationAccuracy : qreal

В этом свойстве указывается точность определения местоположения пользователя.

UserLocationAccuracy — это qreal-значение, представляющее точность данных о местоположении пользователя, обычно в метрах.

Функции доступа:

qreal	getUserLocationAccuracy() const
void	setUserLocationAccuracy(qreal userLocationAccuracy)

Сигнал уведомления:

void	userLocationAccuracyChanged(qreal userLocationAccuracy)

userMarker : QVariantMap

Это свойство содержит настройки для маркера местоположения пользователя на карте.

UserMarker — это QVariantMap, содержащий свойства для настройки внешнего вида и поведения маркера местоположения пользователя.

QVariantMap userMarker{
  {"image", QVariantMap()}, // Представляет изображение, используемое для маркера. По умолчанию используется пустой QVariantMap, что означает отсутствие изображения. Это поле предназначено для содержания SVG-графики для высококачественных, масштабируемых маркеров.
  {"accuracyColor", "#87cefa"}, // Строка, задающая цвет круга точности вокруг пользовательского маркера. По умолчанию используется светло-голубой цвет ("#87cefa"), представляющий область, в которой, как ожидается, будет найдено фактическое местоположение пользователя.
  {"accuracyOpacity", 0.25}, // qreal значение, указывающее на непрозрачность круга точности. По умолчанию установлено значение 0,25, что обеспечивает полупрозрачную визуализацию области точности, позволяющую видеть основные детали карты.
  {"accuracyDefaultRadius", 50} // qreal значение, задающее радиус по умолчанию (в пикселях) круга точности. По умолчанию установлено значение 50 пикселей, что отражает предполагаемую точность определения местоположения пользователя. Этот радиус может быть скорректирован с учетом фактической точности, обеспечиваемой данными о местоположении.
};

Функции доступа:

QVariantMap	getUserMarker() const
void	setUserMarker(QVariantMap userMarker)

Сигнал уведомления:

void	userMarkerChanged(QVariantMap userMarker)

zoomLevel : qreal

Это свойство определяет уровень масштабирования карты.

Уровень масштабирования — это qreal-значение, определяющее масштаб карты. Более высокие значения позволяют приблизить область карты.

Функции доступа:

qreal	getZoomLevel() const
void	setZoomLevel(qreal zoomLevel, const QPointF &center = QPointF())

Сигнал уведомления:

void	zoomLevelChanged(qreal zoomLevel)

Описание функций-членов

MfwMap::MfwMap(QQuickItem *parent = nullptr)

Конструктор для класса MfwMap.

Этот конструктор инициализирует экземпляр класса MfwMap, с необязательным родителем. Он устанавливает необходимые свойства и конфигурации для карты.

• parent — родительский QQuickItem, обычно nullptr для элементов верхнего уровня.

MfwMap::~MfwMap()

MfwMap::~MfwMap()

Деструктор для класса MfwMap.

Очищает все ресурсы, используемые экземпляром MfwMap.

[signal] void MfwMap::accessTokenChanged(QString token)

Сигнал испускается при изменении маркера доступа карты.

Этот сигнал испускается при изменении токена доступа, используемого для аутентифицированных служб и источников данных.

• token — новый токен доступа.

Примечание. Сигнал нотификатора для свойства accessToken.

void MfwMap::addImage(const QString &name, const QImage &sprite)

Добавляет изображение в стиль карты.

Включение изображения в стиль карты, которое может быть использовано в слоях и других компонентах стиля.

• name — имя, которое нужно присвоить изображению.
• sprite — изображение как QImage.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addImage(name, sprite)
        }
    }
}

bool MfwMap::addImagePath(const QString &name, const QString &path, const int svgX = 0, const int svgY = 0)

Добавляет изображение из файла по пути к стилю карты. Возвращает true в случае успеха; иначе false.

Включает изображение из пути к файлу в стиль карты. Изображение может быть частью SVG-файла.

• name — имя, которое нужно присвоить изображению.
• path — путь к файлу изображения.
• svgX — необязательная координата X для SVG-изображений.
• svgY — необязательная координата Y для SVG-изображений.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addImagePath(name, path, svgX, svgY)
        }
    }
}

void MfwMap::addLayer(const QString &id, const QVariantMap &params, const QString &before = QString())

Добавляет новый слой на карту с указанными параметрами.

Создает и добавляет новый слой на карту, используя заданные параметры. Опционально задаёт порядок укладки слоя относительно других слоев.

• id — идентификатор нового слоя.
• params — параметры, определяющие свойства слоя.
• before — идентификатор существующего слоя, под которым будет располагаться новый слой. Если не указано, слой добавляется сверху.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(56.858511, 35.912008) //Tver

        zoomLevel: 16.0

        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            var markerSource = {
                "type": "geojson",
                "data": {
                    "type": "Feature",
                    "properties": {},
                    "geometry": {
                        "type": "Point",
                        "coordinates": [coord.longitude, coord.latitude]
                    }
                }
            };

            map.addSource("marker", markerSource);

            map.addLayer("marker", {
                "type": "circle",
                "source": "marker",
                "paint": {
                    "circle-color": "red",
                    "circle-radius": 10
                }
            });
        }
    }
}

void MfwMap::addMapObject(MfwMapObject *mapObject)

Добавляет объект карты к карте.

Добавляет объект карты, например маркер или полигон, на карту. Затем объект визуализируется в соответствии с его свойствами и местоположением.

• mapObject — объект карты для добавления, как указатель на MfwMapObject. Key — идентификатор объекта MapObject.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addMapObject(mapObj);
        }
    }
}

void MfwMap::addSource(const QString &sourceID, const QVariantMap &params)

Добавляет новый источник в карту с указанными параметрами.

Создает и добавляет новый источник на карту для данных, таких как тайлы или GeoJSON, определяемых заданными параметрами.

• sourceID — уникальный идентификатор для нового источника.
• params — QVariantMap, содержащий параметры для источника (Maplibre API).

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow

        zoomLevel: 16.0

        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            var markerSource = {
                "type": "geojson",
                "data": {
                    "type": "Feature",
                    "properties": {},
                    "geometry": {
                        "type": "Point",
                        "coordinates": [coord.longitude, coord.latitude]
                    }
                }
            };

            map.addSource("marker", markerSource);
        }
    }
}

void MfwMap::addSourceLine(const QString &sourceID, const QVariantList &coordinates, const QString &name = QString())

Добавляет линию к определенному источнику на карте.

Добавляет линию, заданную списком географических координат, к указанному источнику, опционально с именем.

• sourceID — идентификатор источника, к которому добавляется строка.
• coordinates — cписок географических координат, определяющих линию.
• name — необязательное имя для строки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addSourceLine(sourceID, coordinates, name)
        }
    }
}

void MfwMap::addSourcePoint(const QString &sourceID, const QGeoCoordinate &coordinate, const QString &name = QString())

Добавляет точку к определенному источнику на карте.

Добавляет точку, заданную географическими координатами, к указанному источнику, опционально с именем.

• sourceID — идентификатор источника, к которому добавляется точка.
• coordinate — географическая координата точки.
• name — необязательное имя для точки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addSourcePoint(sourceID, coordinate, name)
        }
    }
}

void MfwMap::addSourcePoint(const QString &sourceID, qreal latitude, qreal longitude, const QString &name = QString())

Добавляет точку к определенному источнику на карте, используя значения широты и долготы.

Добавляет точку, заданную широтой и долготой, к указанному источнику, опционально с именем.

• sourceID — идентификатор источника, к которому добавляется точка.
• latitude — широта точки.
• longitude — долгота точки.
• name — необязательное имя для точки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addSourcePoint(sourceID, latitude, longitude, name)
        }
    }
}

void MfwMap::addSourcePoints(const QString &sourceID, const QVariantList &coordinates, const QVariantList &names = QVariantList())

Добавляет несколько точек к определенному источнику на карте.

Добавляет список точек, заданных географическими координатами, к указанному источнику, с необязательными именами.

• sourceID — идентификатор источника, к которому добавляются точки.
• coordinates — список географических координат для точек.
• names — необязательный список имен для точек.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.addSourcePoints(sourceID, coordinates, names)
        }
    }
}

void MfwMap::alignViewToCoordinates(QGeoCoordinate sw, QGeoCoordinate ne)

Выравнивает вид карты по указанным координатам.

Эта функция подстраивает вид карты под прямоугольную область, заданную координатами юго-запада (sw) и северо-востока (ne).

• sw представляет собой юго-западную координату прямоугольной области, на которую должен быть выровнен вид карты. Эта координата служит левым нижним углом прямоугольника, определяя южную и западную границы области, которую вы хотите отобразить.
• ne представляет собой северо-восточную координату прямоугольной области, на которую должен быть выровнен вид карты. Эта координата служит правым верхним углом прямоугольника, определяя северную и восточную границы области, которую вы хотите отобразить.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.alignViewToCoordinates(sw, ne);
        }
    }
}

[signal] void MfwMap::apiBaseUrlChanged(QString url)

Сигнал испускается при изменении базового URL API карты.

Этот сигнал испускается при изменении базового URL для API-запросов карты.

• url — новый базовый URL-адрес API.

Примечание. Сигнал уведомления для свойства apiBaseUrl.

[signal] void MfwMap::apiKeyChanged(QString apiKey)

Сигнал испускается при изменении API-ключа карты.

Этот сигнал испускается при изменении API-ключа, используемого для работы с картографическими сервисами.

• apiKey — новый ключ API в виде QString.

Примечание. Сигнал нотификатора для свойства apiKey.

[signal] void MfwMap::assetPathChanged(QString path)

Сигнал испускается при изменении пути актива карты.

Этот сигнал испускается при изменении пути к файлам активов карты.

• path — путь к новому к ассету.

Примечание. Сигнал уведомления для свойства assetPath.

[signal] void MfwMap::bearingChanged(qreal bearing)

Сигнал испускается при изменении пеленга карты.

Этот сигнал испускается каждый раз, когда обновляется пеленг на карте.

• bearing — обновлённое значение пеленга на карте.

Примечание. Сигнал-уведомление для свойства bearing.

[signal] void MfwMap::bearingEnabledChanged(bool bearingEnabled)

Сигнал испускается при изменении состояния включения пеленга.

Этот сигнал испускается каждый раз, когда обновляется статус пеленга на карте.

• bearingEnabled — обновлённый статус включения пеленга.

Примечание. Сигнал уведомления для свойства bearingEnabled.

[signal] void MfwMap::cacheDatabaseAppNameChanged(QString name)

Сигнал испускается при изменении имени приложения для базы данных кэша карты.

Этот сигнал испускается при изменении имени приложения, связанного с базой данных кэша карты.

• name — новое имя приложения для базы данных кэша.

[signal] void MfwMap::cacheDatabaseDefaultPathChanged(bool defaultpath)

Сигнал испускается при изменении состояния использования пути по умолчанию для базы данных кэша.

Этот сигнал испускается, когда переключается использование пути по умолчанию для базы данных кэша карты.

• defaultpath — булево значение, указывающее на новое состояние использования пути по умолчанию.

Примечание. Сигнал уведомления для свойства cacheDatabaseDefaultPath.

[signal] void MfwMap::cacheDatabaseMaximalSizeChanged(int size)

Сигнал испускается при изменении максимального размера базы данных кэша карты.

Этот сигнал испускается при изменении максимального размера базы данных кэша карты.

• size — новый максимальный размер базы данных кэша.

Примечание. Сигнал уведомления для свойства cacheDatabaseMaximalSize.

[signal] void MfwMap::cacheDatabasePathChanged(QString path)

Сигнал испускается при изменении пути к базе данных кэша карты.

Этот сигнал испускается при изменении пути к файлу базы данных кэша карты.

• path — новый путь к базе данных кэша.

Примечание. Сигнал уведомления для свойства cacheDatabasePath.

[signal] void MfwMap::cacheDatabaseStoreSettingsChanged(bool storesettings)

Сигнал испускается при постоянном изменении состояния хранения настроек базы данных кэша.

Этот сигнал испускается, когда переключается режим постоянного хранения настроек базы данных кэша.

• storesettings — булево значение, указывающее на новое состояние сохранения настроек в постоянном виде.

Примечание. Сигнал уведомления для свойства cacheDatabaseStoreSettings.

[signal] void MfwMap::cacheModeChanged(CacheMode cacheMode)

Сигнал испускается при изменении режима кэширования карты.

Этот сигнал испускается при изменении режима кэширования карты.

• cacheMode — новый режим кэширования карты.

Примечание. Сигнал уведомления для свойства cacheMode.

[signal] void MfwMap::centerChanged(const QGeoCoordinate &coordinate)

Сигнал испускается при изменении центра карты.

Этот сигнал испускается при изменении центра карты.

• coordinate — новый географический центр карты.

Примечание. Сигнал уведомления для свойства center.

void MfwMap::clearCache()

Очищает кэш карты.

Этот метод очищает кэш тайлов карты, удаляя все сохраненные тайлы карты и другие кэшированные данные.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.clearCache()
        }
    }
}

void MfwMap::clearMapObjects()

Удаляет все объекты карты с карты.

Удаляет все добавленные объекты карты с карты, что приводит к их удалению из рендеринга.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.clearMapObjects();
        }
    }
}

[signal] void MfwMap::clickSizeChanged(qreal clickSize)

Сигнал испускается при изменении размера щелчка.

Этот сигнал испускается каждый раз, когда обновляется размер клика для взаимодействия с картой.

• clickSize — обновлённое значение размера щелчка.

Примечание. Сигнал уведомления для свойства clickSize.

[signal] void MfwMap::clicked(QPointF coordinate, QPoint point)

Сигнал испускается при нажатии на карту.

Этот сигнал испускается при возникновении события щелчка на карте, предоставляя географические и экранные координаты щелчка.

• coordinate — географическая координата щелчка.
• point — экранная координата щелчка.

QVariantList MfwMap::defaultStyles() const

Получает список стилей по умолчанию, доступных для карты.

Возвращает список вариантов карт, каждый из которых представляет собой стиль по умолчанию, доступный для данной карты.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.defaultStyles()
        }
    }
}

[signal] void MfwMap::devicePixelRatioChanged(qreal devicePixelRatio)

Сигнал испускается при изменении соотношения пикселей устройства карты.

Этот сигнал испускается при изменении соотношения пикселей устройства, используемого для рендеринга карты.

• devicePixelRatio — новое соотношение пикселей устройства.

Примечание. Сигнал уведомления для свойства devicePixelRatio.

[signal] void MfwMap::doubleClickDelayChanged(qreal doubleClickDelay)

Сигнал испускается при изменении задержки двойного щелчка.

Этот сигнал испускается каждый раз, когда обновляется задержка для взаимодействия с двойным щелчком мыши на карте.

• doubleClickDelay — обновлённое значение задержки двойного щелчка.

Примечание. Сигнал уведомления для свойства doubleClickDelay.

[signal] void MfwMap::doubleClickLengthDeltaChanged(qreal doubleClickLengthDelta)

Сигнал испускается при изменении дельты длины двойного щелчка.

Этот сигнал испускается каждый раз, когда обновляется дельта длины для взаимодействий двойного щелчка на карте.

• doubleClickLengthDelta — обновлённое значение дельты длины двойного щелчка.

Примечание. Сигнал уведомления для свойства doubleClickLengthDelta.

[signal] void MfwMap::error(MapError code, QString message)

Сигнал испускается при возникновении ошибки в компоненте карты.

Этот сигнал испускается, когда карта сталкивается с ошибкой, предоставляя код ошибки и описательное сообщение.

• code — код ошибки типа MapError.
• message — описательное сообщение об ошибке.

[signal] void MfwMap::errorChanged(QString error)

Сигнал испускается при возникновении ошибки в карте.

Этот сигнал испускается при возникновении ошибки во время работы карты.

• error — сообщение об ошибке.

Примечание. Сигнал нотификатора для свойства errorString.

void MfwMap::findMapObject(QGeoCoordinate diagonalCoordinate1, QGeoCoordinate diagonalCoordinate2, const QVariant &tag = QVariant())

Находит объекты карты в заданной области.

Эта функция ищет объекты карты в пределах прямоугольной области, заданной двумя диагональными координатами. Параметр 'tag' может использоваться для передачи дополнительной информации для поиска.

• diagonalCoordinate1 представляет собой первую диагональную координату прямоугольной области поиска. Это может быть левый верхний или правый нижний угол, в зависимости от его положения относительно diagonalCoordinate2.
• diagonalCoordinate2 представляет собой вторую диагональную координату прямоугольной области поиска, противоположную diagonalCoordinate1. Используется вместе с diagonalCoordinate1 для определения области поиска.
• tag — необязательный параметр (строка), который может быть использован для передачи дополнительной информации или критериев для фильтрации поиска. Это могут быть любые данные, относящиеся к объектам карты, например, определенная категория, тип или любой другой атрибут, которым могут быть помечены объекты карты.

void MfwMap::fitView(const QVariantList &coordinates, bool preserve = false)

Настраивает вид карты, чтобы охватить список координат.

Изменяет вид карты таким образом, чтобы все указанные географические координаты были видны в текущем окне просмотра карты.

• coordinates — список объектов QGeoCoordinate, представляющих местоположения для включения в представление.
• preserve — булево значение, указывающее, сохранять ли текущий уровень масштабирования.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.fitView(coordinates, preserve)
        }
    }
}

[signal] void MfwMap::gestureInProgressChanged(bool gestureInProgress)

Сигнал испускается при изменении состояния выполнения жеста.

Этот сигнал испускается, когда на карте начинается или заканчивается жест (например, сжатие или панорамирование).

• gestureInProgress — новое состояние выполнения жеста.

Примечание. Сигнал уведомления для свойства gestureInProgress.

QString MfwMap::getCacheDatabasePath() const

Получает путь к базе данных кэша карты.

Возвращает путь к файлу базы данных кэша карты, используемой для хранения отрисованных плиток карты и других данных.

Примечание. Геттер для свойства cacheDatabasePath.

[protected] QString MfwMap::getLangIsoCodeString(LangIsoCode langIsoCode)

Преобразует значение перечисления LangIsoCode в его соответствующее строковое представление.

Этот метод преобразует значение перечисления LangIsoCode в читаемую строку, представляющую код языка.

• langIsoCode — это значение перечисления типа LangIsoCode, которое представляет различные поддерживаемые языки. Каждое значение перечисления соответствует отдельному языку, и этот метод преобразует значение перечисления в строку, соответствующую коду ISO для этого языка. Например, преобразование LangIsoCode::English дает строку "name_en", указывающую на ISO-код английского языка.

[signal] void MfwMap::langIsoCodeChanged(LangIsoCode langIsoCode)

Сигнал испускается при изменении ISO-кода языка.

Этот сигнал испускается каждый раз, когда обновляются языковые настройки для меток и текста карты.

• langIsoCode — обновлённое значение LangIsoCode.

Примечание. Сигнал уведомления для свойства langIsoCode.

[signal] void MfwMap::locationChanged(QString id, bool visible, const QPoint pixel)

Сигнал испускается при обновлении отслеживаемого местоположения.

Этот сигнал испускается при обновлении отслеживаемого местоположения на карте, обеспечивая его идентификатор, видимость и положение на экране.

• id — идентификатор отслеживаемого местоположения.
• visible — булево число, указывающее на видимость местоположения.
• pixel — экранная позиция отслеживаемого местоположения.

[signal] void MfwMap::locationTrackingRemoved(QString id)

Сигнал испускается при удалении отслеживания местоположения для определенного идентификатора.

Этот сигнал испускается, когда отслеживание местоположения, идентифицированного предоставленным идентификатором, прекращается.

• id — идентификатор отслеживания местоположения, которое было удалено.

[signal] void MfwMap::logoClicked()

Сигнал испускается при нажатии на логотип карты.

Этот сигнал испускается всякий раз, когда пользователь нажимает на логотип карты.

[signal] void MfwMap::longPressed(QGeoCoordinate coordinate, QGeoCoordinate point)

Сигнал испускается при длительном нажатии на карту.

Этот сигнал испускается, когда на карте происходит событие длительного нажатия, с указанием географических и экранных координат нажатия.

• coordinate — географическая координата длительного нажатия.
• point — экранная координата длительного нажатия.

[signal] void MfwMap::mapObjectAdded(MfwMapObject *mapObject)

Сигнал испускается при добавлении объекта карты.

Этот сигнал испускается, когда на карту добавляется новый объект.

• mapObject — объект карты, который был добавлен.

[signal] void MfwMap::mapObjectClicked(QString id, QGeoCoordinate coordinate)

Сигнал испускается при нажатии на объект карты.

Этот сигнал испускается, когда объект карты с указанным 'id' нажимается на 'coordinate'.

• id — идентификатор щелкнутого объекта карты.
• coordinate — географическая координата, где произошел щелчок.

[signal] void MfwMap::mapObjectRemoved(MfwMapObject *item)

Сигнал испускается при удалении объекта карты.

Этот сигнал испускается, когда объект карты удаляется с карты.

• item — объект карты, который был удален.

[signal] void MfwMap::mapObjectsChanged(QVariantMap mapObject)

Сигнал испускается при изменении или обновлении объектов карты.

Этот сигнал испускается всякий раз, когда происходит изменение или обновление объектов карты.

• mapObject — QVariantMap, содержащий обновлённые объекты карты.

Примечание. Сигнал уведомления для свойства mapObjects.

[signal] void MfwMap::mapToQtPixelRatioChanged(qreal mapToQtPixelRatio)

Сигнал испускается при изменении соотношения пикселей карты и Qt.

Этот сигнал испускается при изменении соотношения между пикселями карты и логическими пикселями Qt.

• mapToQtPixelRatio — новое соотношение пикселей карты и Qt.

Примечание. Сигнал уведомления для свойства mapToQtPixelRatio.

[signal] void MfwMap::marginsChanged(const QMarginsF &margins)

Сигнал испускается при изменении границ карты.

Этот сигнал испускается при изменении полей вокруг вида карты.

• margins — новые поля вокруг вида карты.

Примечание. Сигнал уведомления для свойства margins.

[signal] void MfwMap::maximumZoomLevelChanged()

Сигнал испускается при изменении максимального масштаба карты.

Этот сигнал испускается при изменении максимального уровня масштабирования карты.

Примечание. Сигнал уведомления для свойства maximumZoomLevel.

[signal] void MfwMap::metersPerPixelChanged(qreal metersPerPixel)

Сигнал испускается при изменении значения метр на пиксель.

Этот сигнал испускается при изменении масштаба карты, влияя на значение "метр на пиксель".

• metersPerPixel — новое значение метров на пиксель.

Примечание. Сигнал уведомления для свойства metersPerMapPixel. Сигнал уведомления для свойства metersPerPixel.

[signal] void MfwMap::metersPerPixelToleranceChanged(qreal metersPerPixelTolerance)

Сигнал испускается при изменении допуска на метры на пиксель.

Этот сигнал испускается при обновлении значения допуска для метров на пиксель.

• metersPerPixelTolerance — новое значение допуска для метров на пиксель.

Примечание. Сигнал уведомления для свойства metersPerPixelTolerance.

[signal] void MfwMap::minimumZoomLevelChanged()

Сигнал испускается при изменении минимального уровня масштабирования карты.

Этот сигнал испускается при изменении минимального уровня масштабирования карты.

Примечание. Сигнал уведомления для свойства minimumZoomLevel.

[signal] void MfwMap::modeChanged(MapMode mapMode)

Сигнал испускается при изменении режима карты.

Этот сигнал испускается при изменении режима работы карты, указывая на переключение между различными режимами работы.

• mapMode — новый режим карты типа MapMode.

Примечание. Сигнал уведомления для свойства mode.

[signal] void MfwMap::objectClicked(MfwMapObject *object, QGeoCoordinate coordinate, QGeoCoordinate point)

Сигнал испускается при нажатии на объект карты.

Этот сигнал испускается при наступлении события щелчка на объекте карты, предоставляя информацию об объекте, его географическом положении и экранных координатах.

• object — объект карты, на котором был сделан щелчок.
• coordinate — географическая координата щелчка.
• point — экранная координата щелчка.

void MfwMap::pan(int dx, int dy)

Разворачивает карту на указанное количество пикселей.

Разворачивает карту по горизонтали на dx пикселей и по вертикали на dy пикселей.

• dx — горизонтальный размер пикселя для панорамирования.
• dy — вертикальный размер пикселя для панорамирования.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.pan(dx, dy);
        }
    }
}

[signal] void MfwMap::panFactorChanged(qreal panFactor)

Сигнал испускается при изменении коэффициента панорамирования.

Этот сигнал испускается каждый раз, когда обновляется чувствительность жестов панорамирования на карте.

• panFactor — обновлённое значение фактора панорамирования.

Примечание. Сигнал уведомления для свойства panFactor.

[signal] void MfwMap::pinchFactorChanged(qreal pinchFactor)

Сигнал испускается при изменении коэффициента защемления.

Этот сигнал испускается каждый раз, когда обновляется чувствительность жестов сжатия на карте.

• pinchFactor — обновлённое значение фактора защемления.

Примечание. Сигнал уведомления для свойства pinchFactor.

[signal] void MfwMap::pitchChanged(qreal pitch)

Сигнал испускается при изменении наклона карты.

Этот сигнал испускается при изменении угла наклона карты.

• pitch — новый угол наклона карты в градусах.

Примечание. Сигнал-уведомление для свойства pitch.

[signal] void MfwMap::pixelRatioChanged(qreal pixelRatio)

Сигнал испускается при изменении соотношения пикселей карты.

Этот сигнал испускается при изменении соотношения пикселей, используемого для рендеринга карты.

• pixelRatio — новое соотношение пикселей.

Примечание. Сигнал уведомления для свойства pixelRatio.

[signal] void MfwMap::queryCoordinateForPixel(const QPointF p, const QVariant &tag = QVariant())

Запрашивает географические координаты для заданной позиции пикселя.

Запрашивает карту для преобразования позиции пикселя в соответствующую географическую координату.

• p — положение пикселя на карте.
• tag — необязательный тег, который нужно связать с запросом.

[signal] void MfwMap::queryCoordinateToFindMapObject(QPointF p, float radius, const QVariant &tag = QVariant())

Инициирует запрос на поиск объектов карты в пределах заданного радиуса от точки.

Этот метод используется для поиска объектов карты в радиусе (в пикселях) от заданной точки на карте. 'Tag' может быть использован для дополнительного контекста.

• p — это QPointF, представляющий географические координаты центральной точки области поиска на карте. Эта точка служит ориентиром для радиуса, в пределах которого ведется поиск.
• radius — это float, задающий радиус поиска в пикселях. Определяет круговую область вокруг точки p, в пределах которой будут искаться объекты карты. Радиус определяет, на каком расстоянии от точки могут находиться объекты, чтобы их можно было включить в результаты поиска.
• tag — необязательный параметр QVariant, который может быть использован для предоставления дополнительного контекста или критериев фильтрации для поиска. Например, можно указать атрибуты или категории объектов карты, которые следует включить или исключить из результатов поиска, тем самым уточняя поиск в соответствии с потребностями конкретного приложения.

[signal] void MfwMap::queryCoordinateZoomForBounds(QGeoCoordinate sw, QGeoCoordinate ne)

Запрашивает координаты и уровень масштабирования, которые соответствуют указанным границам.

Этот метод рассчитывает оптимальные координаты и уровень масштабирования для соответствия заданным юго-западной (sw) и северо-восточной (ne) границам на карте.

• sw — это QGeoCoordinate, представляющая юго-западный угол границы. Эта координата отмечает левый нижний угол прямоугольника, определяя южную и западную границы отображаемой области.
• ne — это QGeoCoordinate, представляющая северо-восточный угол границы. Эта координата отмечает правый верхний угол прямоугольника, определяя северную и восточную границы отображаемой области.

[signal] void MfwMap::queryLayerExists(const QString id)

Запрашивает, существует ли на карте слой с заданным идентификатором.

Этот метод используется для запроса, существует ли на карте слой, распознанный указанным идентификатором.

• id — идентификатор слоя для проверки.

[signal] void MfwMap::queryPixelForCoordinate(double lat, double lng, const QVariant &tag = QVariant())

Запрашивает положение пикселя для заданной географической координаты.

Этот метод преобразует географические координаты (широту, долготу) в положение пикселя на карте. 'Tag' может обеспечить дополнительный контекст для запроса.

• lat — двойное значение, представляющее широту географической координаты. Широты варьируются от -90 градусов (юг) до +90 градусов (север).
• lng — двойное значение, представляющее долготу географической координаты. Долготы варьируются от -180 градусов (запад) до +180 градусов (восток).
• tag — необязательный QVariant, используемый для предоставления дополнительного контекста или идентификации запроса. Это может быть такая информация, как цель запроса, тип представляемого объекта или другие метаданные.

[signal] void MfwMap::querySourceExists(const QString id)

Запрашивает, существует ли на карте источник с заданным идентификатором.

Этот метод используется для запроса, существует ли на карте источник, идентифицированный по указанному идентификатору.

• id — идентификатор источника для проверки.

void MfwMap::removeAllLocationTracking()

Удаляет все отслеживание местоположения с карты.

Прекращает отслеживание всех мест, ранее установленных для отслеживания на карте.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeAllLocationTracking()
        }
    }
}

void MfwMap::removeImage(const QString &name)

Удаляет изображение из стиля карты.

Удаляет изображение, ранее добавленное в стиль карты.

• name — имя изображения, которое нужно удалить.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeImage(name)
        }
    }
}

void MfwMap::removeLayer(const QString &id)

Удаляет слой с карты.

Удаляет с карты слой, распознанный указанным идентификатором.

• id — идентификатор слоя, который нужно удалить.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeLayer(id)
        }
    }
}

void MfwMap::removeLocationTracking(const QString &id)

Удаляет отслеживание местоположения для определенного идентификатора.

Прекращает отслеживание местоположения, распознанного указанным идентификатором.

• id — идентификатор отслеживания местоположения для удаления.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeLocationTracking(id)
        }
    }
}

void MfwMap::removeMapObject(MfwMapObject *item)

Удаляет объект карты с карты.

Удаляет указанный объект карты из карты. Объект больше не будет отображаться.

• item — объект карты для удаления, как указатель на MfwMapObject.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeMapObject(mapObj);
        }
    }
}

void MfwMap::removeSource(const QString &sourceID)

Удаляет источник из карты.

Удаляет указанный источник и связанные с ним данные с карты.

• sourceID — идентификатор источника, который необходимо удалить.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.removeSource(sourceID)
        }
    }
}

[signal] void MfwMap::replyCoordinateForPixel(const QPointF pixel, QGeoCoordinate geocoordinate, qreal degLatPerPixel, qreal degLonPerPixel, const QVariant &tag = QVariant())

Сигнал, испускаемый в ответ на запрос координат по пикселям.

Этот сигнал предоставляет результат запроса на преобразование положения пикселя в географические координаты.

• pixel — запрашиваемая позиция пикселя.
• geocoordinate — результирующая географическая координата.
• degLatPerPixel — градусы широты на пиксель.
• degLonPerPixel — градусы долготы на пиксель.
• tag — необязательный тег, связанный с запросом.

[signal] void MfwMap::replyLayerExists(const QString id, bool exists)

Сигнал, испускаемый в ответ на запрос существования слоя.

Этот сигнал предоставляет результат запроса, проверяющего, существует ли на карте слой с заданным идентификатором.

• id — идентификатор запрашиваемого слоя.
• exists — булево число, указывающее, существует ли слой.

[signal] void MfwMap::replyPixelForCoordinate(QPointF screenPoint, const QVariant &tag = QVariant())

Отвечает на запрос pixel-for-coordinate.

Этот сигнал испускается в ответ на запрос pixel-for-coordinate, предоставляя положение пикселя на экране для ранее запрошенной географической координаты.

• screenPoint — это QPointF, представляющий позицию пикселя на экране карты, соответствующую географической координате. Эта точка указывает на координаты x и y пикселей на экране, где находится географическая координата, что облегчает размещение маркеров, символов или других визуальных представлений в точных местах на карте.
• tag — необязательный параметр QVariant, который может быть использован для связывания дополнительной информации или контекста с ответом. Это может быть использовано для идентификации запроса, соотнесения ответа с запросом или для передачи любых других данных, которые могут потребоваться для обработки ответа или управления несколькими запросами.

[slot] void MfwMap::replyRTreeBoxChanged(box oldRTreeBox, box rTreeBox, MfwMapObject *obj)

Обрабатывает изменение индекса позиции для объекта карты.

При изменении границ объекта карты обновляет его позицию в R-дереве, чтобы поддерживать пространственный индекс в актуальном состоянии.

• oldRTreeBox — старые границы объекта в R-дереве.
• rTreeBox — новые границы объектов в R-дереве.
• obj — указатель на объект карты, для которого произошло изменение.

[signal] void MfwMap::replySourceExists(const QString id, bool exists)

Сигнал, испускаемый в ответ на запрос о существовании источника.

Этот сигнал предоставляет результат запроса, проверяющего, существует ли на карте источник с заданным идентификатором.

• id — идентификатор запрашиваемого источника.
• exists — булево число, указывающее, существует ли источник.

[signal] void MfwMap::rotateFactorChanged(qreal rotateFactor)

Сигнал испускается при изменении коэффициента поворота.

Этот сигнал испускается каждый раз, когда обновляется чувствительность жестов вращения на карте.

• rotateFactor — обновлённое значение фактора поворота.

Примечание. Сигнал уведомления для свойства rotateFactor.

[signal] void MfwMap::rotationSensitivityChanged(qreal rotationSensitivity)

Сигнал испускается при изменении чувствительности вращения.

Этот сигнал испускается каждый раз, когда обновляется чувствительность к вращательным взаимодействиям на карте.

• rotationSensitivity — обновлённое значение чувствительности к вращению.

Примечание. Сигнал уведомления для свойства rotationSensitivity.

void MfwMap::setAccessToken(const QString &token)

Устанавливает токен доступа, используемый для аутентифицированных служб и источников данных.

Устанавливает токен доступа, необходимый для доступа к некоторым службам карты и источникам данных, требующим аутентификации.

• token — токен доступа в виде QString.

Примечание. Сеттер для свойства accessToken.

void MfwMap::setApiBaseUrl(const QString &url)

Устанавливает базовый URL для API-запросов карты.

Устанавливает базовый URL-адрес, используемый для всех API-запросов, выполняемых картой, например, для запросов плитки или стиля.

• url — базовый URL в виде QString.

Примечание. Сеттер для свойства apiBaseUrl.

void MfwMap::setApiKey(QString apiKey)

Устанавливает ключ API, используемый для картографических сервисов.

Устанавливает ключ API для аутентификации с поставщиками картографических услуг. Этот ключ необходим для доступа к определенным функциям или данным провайдера.

• apiKey — ключ API в виде QString.

Примечание. Сеттер для свойства apiKey.

void MfwMap::setBearing(qreal b)

Устанавливает пеленг карты.

Устанавливает пеленг карты на указанный угол в градусах. Пеленг — это направленный угол, измеряемый по часовой стрелке от севера.

• b — пеленг в градусах.

Примечание. Сеттер для свойства bearing.

void MfwMap::setBearingEnabled(bool bearingEnabled)

Включает или выключает функцию пеленгации на карте.

Устанавливает, должна ли карта отображать и корректировать свой пеленг, или направление, на основе заданного булевого значения.

• bearingEnabled — булево значение, определяющее состояние функции пеленгации на карте. Если установить значение true, пеленг на карте будет отображаться и обновляться на основе направления движения пользователя или других критериев, определенных приложением. Если установить значение false, функция пеленгации будет отключена, и карта не будет отображать или корректировать свое направление на основе информации о пеленгах.

Примечание. Сеттер для свойства bearingEnabled.

void MfwMap::setCacheDatabaseDefaultPath(bool s)

Устанавливает, использовать ли путь по умолчанию для базы данных кэша.

Если установлено значение true, карта использует путь по умолчанию для базы данных кэша.

• s — булево значение, указывающее, использовать ли путь по умолчанию.

Примечание. Сеттер для свойства cacheDatabaseDefaultPath.

void MfwMap::setCacheDatabaseMaximalSize(int sz)

Устанавливает максимальный размер базы данных кэша карты.

Устанавливает максимальный размер базы данных кэша карты, в байтах.

• sz — максимальный размер базы данных кэша в байтах.

Примечание. Сеттер для свойства cacheDatabaseMaximalSize.

void MfwMap::setCacheDatabasePath(const QString &path)

Обновляет местоположение базы данных кэша на указанный путь.

Определяет соответствующий путь к файлу для базы данных кэша карты. Если указанный каталог не существует, он пытается его создать. При неудачном создании каталога записывается сообщение об ошибке с подробным описанием неудачной операции. После успешного обновления или создания каталога испускается сигнал, указывающий на изменение пути к базе данных кэша.

Этот метод гарантирует, что кэш-данные карты будут храниться в нужном месте, что повышает гибкость управления данными.

• path указывает новый путь к файлу для базы данных кэша карты. Это должен быть действительный путь к файловой системе, где у приложения есть права на запись. Если путь указывает на несуществующий каталог, метод попытается его создать. В случае успеха база данных кэша будет сохранена в этом месте; в случае неудачи будет залоггирована ошибка.

Примечание. Сеттер для свойства cacheDatabasePath.

void MfwMap::setCacheDatabaseStoreSettings(bool s)

Устанавливает, хранить ли настройки базы данных кэша постоянно.

Если установлено значение true, настройки базы данных кэша будут храниться постоянно.

• s — булево значение, указывающее, сохранять ли настройки постоянно.

Примечание. Сеттер для свойства cacheDatabaseStoreSettings.

void MfwMap::setCacheMode(CacheMode cacheMode)

Устанавливает режим кэширования карты.

Устанавливает режим кэширования для карты. Режим определяется перечислением CacheMode и влияет на то, как кэшируются данные карты.

• cacheMode — режим кэширования, который необходимо установить.

Примечание. Сеттер для свойства cacheMode.

[slot] void MfwMap::setCenter(const QGeoCoordinate &coordinate)

Устанавливает новый центр карты.

Этот метод устанавливает coordinate в качестве новой центральной точки карты. Если координата отличается от текущего центра, обновляется состояние карты и испускается сигнал centerChanged.

• coordinate — новая центральная координата для карты.

Примечание. Сеттер для свойства center.

void MfwMap::setClickSize(qreal clickSize)

Устанавливает размер щелчка для карты.

Обновляет размер для обнаружения щелчка мыши на указанное значение qreal.

• clickSize — размер щелчка, который необходимо установить.

Примечание. Сеттер для свойства clickSize.

void MfwMap::setDevicePixelRatio(qreal devicePixelRatio)

Устанавливает соотношение пикселей устройства, используемое для рендеринга карты.

Устанавливает соотношение пикселей устройства, влияющее на масштабирование и отображение элементов карты на дисплеях высокой плотности.

• devicePixelRatio — отношение пикселей устройства в виде qreal-значения.

Примечание. Сеттер для свойства devicePixelRatio.

void MfwMap::setDoubleClickDelay(qreal doubleClickDelay)

Устанавливает задержку двойного щелчка для карты.

Обновляет максимальную продолжительность двойного щелчка мыши на указанное значение qreal.

• doubleClickDelay — задержка двойного щелчка, которую нужно установить.

Примечание. Сеттер для свойства doubleClickDelay.

void MfwMap::setDoubleClickLengthDelta(qreal doubleClickLengthDelta)

Устанавливает дельту длины двойного щелчка для карты.

Обновляет максимальное расстояние для двойного клика на указанное значение qreal.

• doubleClickLengthDelta — дельта длины двойного щелчка для установки.

Примечание. Сеттер для свойства doubleClickLengthDelta.

void MfwMap::setGestureInProgress(bool progress)

Устанавливает состояние выполняемого жеста на карте.

Если установлено значение true, это означает, что в данный момент на карте выполняется жест.

• progress — булево значение, указывающее на состояние прогресса жеста.

Примечание. Сеттер для свойства gestureInProgress.

void MfwMap::setLangIsoCode(LangIsoCode langIsoCode)

Устанавливает код языка ISO для карты.

Обновляет языковые настройки для меток и текста карты на основе заданного значения перечисления LangIsoCode.

• langIsoCode — это перечисление типа LangIsoCode, которое указывает новую языковую настройку для карты. Каждое значение в перечислении LangIsoCode соответствует различному коду языка ISO, представляющему такие поддерживаемые языки, как английский, французский, испанский и т.д. Когда этот метод вызывается с определенным значением LangIsoCode, он обновляет языковые настройки карты, чтобы отображать метки и текст на выбранном языке.

Примечание. Сеттер для свойства langIsoCode.

void MfwMap::setLayoutProperty(const QString &layer, const QString &property, const QVariant &value)

Устанавливает свойство макета для определенного слоя.

Изменяет свойство макета указанного слоя.

• layer — идентификатор слоя, который нужно изменить.
• property — имя свойства макета, которое нужно установить.
• value — новое значение свойства.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setLayoutProperty(layer, property, value)
        }
    }
}

void MfwMap::setLayoutPropertyList(const QString &layer, const QString &property, const QVariantList &value)

Устанавливает свойство макета на основе списка для определенного слоя.

Изменяет списочное свойство макета указанного слоя.

• layer — идентификатор слоя, который нужно изменить.
• property — имя свойства макета, которое нужно установить.
• value — новый список значений для свойства.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setLayoutPropertyList(layer, property, value)
        }
    }
}

void MfwMap::setMargins(qreal left, qreal top, qreal right, qreal bottom)

Устанавливает поля вокруг вида карты.

Определяет поля вокруг вида карты, чтобы контролировать смещение видимой области от краев компонента карты.

• left — левое поле в пикселях.
• top — верхнее поле в пикселях.
• right — правое поле в пикселях.
• bottom — нижнее поле в пикселях.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setMargins(left, top, right, bottom);
        }
    }
}

Примечание. Сеттер для свойства margins.

void MfwMap::setMargins(const QRectF &margins_box)

Устанавливает поля вокруг представления карты с помощью QRectF.

Определяет границы вокруг представления карты на основе предоставленного QRectF.

• margins_box — QRectF, определяющий границы вокруг вида карты.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setMargins(margins_box);
        }
    }
}

Примечание. Сеттер для свойства margins.

void MfwMap::setMaximumZoomLevel(qreal maximumZoomLevel)

Устанавливает максимальный уровень масштабирования карты.

Определяет максимальный уровень масштабирования, до которого пользователь может увеличить изображение.

• maximumZoomLevel — максимальный уровень масштабирования в виде qreal-значения.

Примечание. Сеттер для свойства maximumZoomLevel.

void MfwMap::setMetersPerPixelTolerance(qreal tol)

Устанавливает уровень допуска для расчета количества метров на пиксель.

Устанавливает уровень точности вычисления значения metersPerPixel.

• tol — уровень допуска в виде qreal-значения.

Примечание. Сеттер для свойства metersPerPixelTolerance.

void MfwMap::setMinimumZoomLevel(qreal minimumZoomLevel)

Устанавливает минимальный уровень масштабирования карты.

Определяет самый низкий уровень масштабирования, до которого пользователь может уменьшить масштаб.

• minimumZoomLevel — минимальный уровень масштабирования в виде qreal-значения.

Примечание. Сеттер для свойства minimumZoomLevel.

void MfwMap::setMode(MapMode mapMode)

Устанавливает режим работы карты.

Устанавливает режим работы карты. Режим определяется перечислением MapMode и влияет на поведение и рендеринг карты.

• mapMode — режим, в котором будет установлена карта.

Примечание. Сеттер для свойства mode.

void MfwMap::setPaintProperty(const QString &layer, const QString &property, const QVariant &value)

Устанавливает свойство окраски для определенного слоя.

Изменяет свойство окраски указанного слоя.

• layer — идентификатор слоя, который нужно изменить.
• property — имя свойства окраски, которое нужно установить.
• value — новое значение свойства.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setPaintProperty(layer, property, value)
        }
    }
}

void MfwMap::setPaintPropertyList(const QString &layer, const QString &property, const QVariantList &value)

Устанавливает списочное свойство окраски для определенного слоя.

Изменяет списочное свойство окраски указанного слоя.

• layer — идентификатор слоя, который нужно изменить.
• property — имя свойства окраски, которое нужно установить.
• value — новый список значений для свойства.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setPaintPropertyList(layer, property, value)
        }
    }
}

void MfwMap::setPanFactor(qreal panFactor)

Устанавливает коэффициент панорамирования для карты.

Обновляет чувствительность карты к жестам панорамирования на указанное значение qreal.

• panFactor — коэффициент панорамирования, который необходимо установить.

Примечание. Сеттер для свойства panFactor..

void MfwMap::setPinchFactor(qreal pinchFactor)

Устанавливает коэффициент сжатия для карты.

Обновляет чувствительность карты к жестам сжатия на указанное значение qreal.

• pinchFactor — устанавливаемый коэффициент защемления.

Примечание. Сеттер для свойства pinchFactor.

void MfwMap::setPitch(qreal p)

Устанавливает угол наклона вида карты.

Устанавливает угол наклона карты на указанный угол в градусах. Угол наклона — это угол, под которым рассматривается карта, влияющий на перспективу.

• p — угол наклона в градусах.

Примечание. Сеттер для свойства pitch.

void MfwMap::setPixelRatio(qreal pixelRatio)

Устанавливает соотношение пикселей, используемое для отрисовки элементов карты.

Устанавливает соотношение пикселей, которое используется для масштабирования элементов и слоев карты при рендеринге.

• pixelRatio — отношение пикселей в виде qreal-значения.

Примечание. Сеттер для свойства pixelRatio..

void MfwMap::setRotateFactor(qreal rotateFactor)

Устанавливает коэффициент поворота для карты.

Обновляет чувствительность карты к жестам поворота с указанным значением qreal.

• rotateFactor — устанавливаемый коэффициент поворота.

Примечание: Сеттер для свойства rotateFactor.

void MfwMap::setRotationSensitivity(qreal rotationSensitivity)

Устанавливает чувствительность к вращению карты.

Обновляет чувствительность карты к жестам вращения на заданное значение qreal.

• rotationSensitivity — чувствительность карты к жестам вращения.

Примечание. Сеттер для свойства rotationSensitivity.

void MfwMap::setShowUserLocation(bool showUserLocation)

Устанавливает видимость местоположения пользователя на карте.

Если установить значение true, на карте будет отображаться текущее местоположение пользователя.

• showUserLocation — булево значение для определения состояния видимости.

Примечание. Сеттер для свойства showUserLocation.

void MfwMap::setStyleJson(const QString &json)

Устанавливает строку JSON, определяющую стиль карты.

Устанавливает стиль карты с помощью строки в формате JSON.

• json — строка JSON, представляющая стиль карты.

Примечание. Сеттер для свойства styleJson.

void MfwMap::setStyleUrl(const QString &url)

Устанавливает URL-адрес стиля карты.

Устанавливает URL-адрес, указывающий на файл JSON, определяющий визуальный вид карты.

• url — URL в виде QString.

Примечание. Сеттер для свойства styleUrl.

void MfwMap::setTapAndHoldDelay(qreal tapAndHoldDelay)

Устанавливает задержку нажатия и удержания карты.

Обновляет длительность жеста касания и удержания с указанным qreal-значением.

• tapAndHoldDelay — устанавливаемая задержка касания и удержания.

Примечание. Сеттер для свойства tapAndHoldDelay.

void MfwMap::setUrlDebug(bool debug)

Устанавливает состояние отладки URL.

При установке значения true включается протоколирование URL-запросов, выполняемых компонентом map, для целей отладки.

• debug — булево значение для включения или отключения отладки URL.

Примечание. Сеттер для свойства urlDebug.

void MfwMap::setUrlSuffix(const QString &urlsfx)

Устанавливает суффикс URL, используемый для запросов API.

Устанавливает суффикс, который будет добавляться к API-запросам, выполняемым картой, например, дополнительные параметры или токены аутентификации.

• urlsfx — суффикс URL в виде QString.

Примечание. Сеттер для свойства urlSuffix.

void MfwMap::setUseFramebuffer(bool fbo)

Устанавливает, должна ли карта использовать фреймбуфер для рендеринга.

Если установлено значение true, карта будет отрисовываться с помощью объекта буфера кадров (FBO).

• fbo — булево значение для включения или отключения использования фреймбуфера.

Примечание. Сеттер для свойства useFramebuffer.

void MfwMap::setUserDirection(qreal userDirection)

Устанавливает направление пользователя на карте.

Обновляет направление или пеленг пользователя на карте с указанным значением qreal.

• userDirection — направление пользователя, которое необходимо задать, обычно в градусах.

Примечание. Сеттер для свойства userDirection.

void MfwMap::setUserLocation(QGeoCoordinate userLocation)

Устанавливает местоположение пользователя на карте.

Ручная установка местоположения пользователя на указанную географическую координату.

• userLocation — QGeoCoordinate для установки в качестве местоположения пользователя.

Примечание. Сеттер для свойства userLocation..

void MfwMap::setUserLocationAccuracy(qreal userLocationAccuracy)

Устанавливает точность определения местоположения пользователя на карте.

Обновляет точность определения местоположения пользователя на указанное значение qreal, обычно в метрах.

• userLocationAccuracy — точность местоположения пользователя для установки.

Примечание. Сеттер для свойства userLocationAccuracy..

void MfwMap::setUserMarker(QVariantMap userMarker)

Устанавливает настройки пользовательских маркеров на карте.

Обновляет маркер местоположения пользователя на карте с заданными настройками, указанными в QVariantMap.

• userMarker — QVariantMap с настройками маркера.

QVariantMap userMarker{
  {"image", {
        "path" : Qt.resolvedUrl("path/to/marker.svg"),
        "svgX" : 64,
        "svgY" : 64
    }},                // SVG-изображение для маркера. Карта ожидает QVariantMap с деталями изображения, что позволяет создавать масштабируемые и высококачественные представления маркеров.
  {"accuracyColor", "string"}, // Строка, задающая цвет круга точности. Этот цвет визуально представляет область, в которой, скорее всего, будет обнаружено фактическое местоположение пользователя.
  {"accuracyOpacity", qreal}, // qreal значение, задающее непрозрачность круга точности. При меньшем значении круг становится более прозрачным, что позволяет увидеть детали карты.
  {"accuracyDefaultRadius", qreal} // qreal значение, указывающее радиус круга точности по умолчанию в пикселях. Этот размер отражает предполагаемую точность определения местоположения пользователя.
};

Примечание. Сеттер для свойства userMarker.

void MfwMap::setZoomLevel(qreal zoomLevel, const QPointF &center = QPointF())

Устанавливает уровень масштабирования карты, опционально центрируя ее на заданной точке.

Устанавливает уровень масштабирования карты. Если указана точка центра, то при масштабировании карта центрируется на этой точке.

• zoomLevel — новый уровень масштабирования в виде qreal-значения.
• center — центральная точка как QPointF, необязательно.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.setZoomLevel(zoomLevel);
        }
    }
}

Примечание. Сеттер для свойства zoomLevel.

[signal] void MfwMap::showUserLocationChanged(bool showUserLocation)

Сигнал испускается при изменении состояния видимости местоположения пользователя.

Этот сигнал испускается при изменении видимости местоположения пользователя на карте.

• showUserLocation — булево значение, указывающее на новое состояние видимости местоположения пользователя.

Примечание. Сигнал уведомления для свойства showUserLocation..

[signal] void MfwMap::startRefreshTimer()

Запускает таймер обновления карты.

Этот метод запускает таймер, который запускает периодическое обновление карты, обеспечивая регулярное обновление вида карты.

void MfwMap::stopFitView()

Останавливает текущую операцию просмотра облегания.

Отменяет все текущие операции по настройке вида карты для охвата набора координат.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.stopFitView()
        }
    }
}

[signal] void MfwMap::stopRefreshTimer()

Останавливает таймер обновления карты.

Этот метод останавливает таймер, запускающий периодическое обновление карты, прекращая автоматическое обновление.

[signal] void MfwMap::styleJsonChanged(QString json)

Сигнал испускается при изменении JSON стиля карты.

Этот сигнал испускается при изменении строки JSON, определяющей стиль карты.

• json — строка JSON в новом стиле.

Примечание. Сигнал уведомления для свойства styleJson.

[signal] void MfwMap::styleUrlChanged(QString url)

Сигнал испускается при изменении URL-адреса стиля карты.

Этот сигнал испускается при изменении URL-адреса стиля карты.

• url — URL-адрес нового стиля.

[signal] void MfwMap::tapAndHoldDelayChanged(qreal tapAndHoldDelay)

Сигнал испускается при изменении задержки нажатия и удержания.

Этот сигнал испускается всякий раз, когда обновляется задержка для взаимодействия касания и удержания на карте.

• tapAndHoldDelay — обновлённое значение задержки переключения и удержания.

Примечание. Сигнал уведомления для свойства tapAndHoldDelay.

void MfwMap::tapTriggered(QTouchEvent *event)

Обработка жестов касания на карте.

Этот метод вызывается при обнаружении жеста касания, обычно используемого для выбора объектов карты или запуска действий в месте касания.

• event — событие QTouchEvent, связанное с жестом касания.

void MfwMap::trackLocation(const QString &id, const QGeoCoordinate &location)

Отслеживает определенное место на карте.

Устанавливает местоположение для отслеживания на карте, распознаваемое предоставленным идентификатором.

• id — идентификатор для отслеживания местоположения.
• location — географическая координата для отслеживания.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.trackLocation(id, location)
        }
    }
}

void MfwMap::updateSource(const QString &sourceID, const QVariantMap &params)

Обновляет источник на карте с новыми параметрами.

Изменяет свойства указанного источника с помощью карты параметров.

• sourceID — идентификатор источника, который необходимо обновить.
• params — карта параметров для обновления источника.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.updateSource(sourceID, params)
        }
    }
}

void MfwMap::updateSourceLine(const QString &sourceID, const QVariantList &coordinates, const QString &name = QString())

Обновляет линию в определенном источнике на карте.

Обновляет строку в указанном источнике, используя новый список географических координат и необязательное имя.

• sourceID — идентификатор источника, содержащего строку.
• coordinates — список новых географических координат, определяющих линию.
• name — необязательное новое имя для строки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.updateSourceLine(sourceID, coordinates, name)
        }
    }
}

void MfwMap::updateSourcePoint(const QString &sourceID, const QGeoCoordinate &coordinate, const QString &name = QString())

Обновляет точку в определенном источнике на карте.

Обновляет точку в указанном источнике, используя новую географическую координату и необязательное имя.

• sourceID — идентификатор источника, содержащего точку.
• coordinate — новая географическая координата для точки.
• name — необязательное новое имя для точки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.updateSourcePoint(sourceID, coordinate, name)
        }
    }
}

void MfwMap::updateSourcePoint(const QString &sourceID, qreal latitude, qreal longitude, const QString &name = QString())

Обновляет точку в определенном источнике на карте, используя значения широты и долготы.

Обновляет точку в указанном источнике, используя новые значения широты и долготы и необязательное имя.

• sourceID — идентификатор источника, содержащего точку.
• latitude — новая широта для точки.
• longitude — новая долгота для точки.
• name — необязательное новое имя для точки.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.updateSourcePoint(sourceID, latitude, longitude, name)
        }
    }
}

void MfwMap::updateSourcePoints(const QString &sourceID, const QVariantList &coordinates, const QVariantList &names = QVariantList())

Обновляет несколько точек в определенном источнике на карте.

Обновляет список точек в указанном источнике, используя новые географические координаты и необязательные имена.

• sourceID — идентификатор источника, содержащего точки.
• coordinates — список новых географических координат для точек.
• names — необязательный список новых имен для точек.

Page {

    MfwMap {
        id: map

        center: QtPositioning.coordinate(55.752121, 37.617664) // Moscow
        zoomLevel: 16.0
        styleUrl: "https://api.maptiler.com/maps/streets/style.json?key=rIkhrE0BML0xS89iIyfG"
    }

    Button {
        onClicked: {
            map.updateSourcePoints(sourceID, coordinates, names)
        }
    }
}

[signal] void MfwMap::urlDebugChanged(bool urlDebug)

Сигнал испускается при изменении состояния отладки URL карты.

Этот сигнал испускается при включении режима отладки для URL-запросов карты.

• urlDebug — новое состояние отладки URL.

Примечание. Сигнал уведомления для свойства urlDebug.

[signal] void MfwMap::urlSuffixChanged(QString urlSuffix)

Сигнал испускается при изменении суффикса URL карты.

Этот сигнал испускается при изменении суффикса, добавляемого ко всем запросам карты.

• urlSuffix — новый суффикс URL.

Примечание. Сигнал уведомления для свойства urlSuffix.

[signal] void MfwMap::useFramebufferChanged(bool useFramebuffer)

Сигнал испускается при изменении использования фреймбуфера карты.

Этот сигнал испускается при переключении использования фреймбуфера для рендеринга карты.

• useFramebuffer — новое состояние использования фреймбуфера.

Примечание. Сигнал уведомления для свойства useFramebuffer.

[signal] void MfwMap::userDirectionChanged(qreal userDirection)

Этот сигнал испускается при изменении направления движения пользователя на карте.

Этот сигнал необходим для приложений, которые должны реагировать на изменения ориентации пользователя на карте, например, для навигации или функций отслеживания местоположения. Параметр userDirection — это qreal-значение, представляющее новое направление движения пользователя.

• userDirection — новое направление пользователя в градусах, где 0 означает север.

Примечание. Сигнал уведомления для свойства userDirection.

[signal] void MfwMap::userLocationChanged(QGeoCoordinate userLocation)

Сигнал испускается при обновлении местоположения пользователя.

Этот сигнал испускается, когда происходит обновление местоположения пользователя на карте.

• userLocation — новое местоположение пользователя в виде QGeoCoordinate.

Примечание. Сигнал уведомления для свойства userLocation.

[signal] void MfwMap::userMarkerChanged(QVariantMap userMarker)

Сигнал испускается при изменении настроек пользовательского маркера.

Этот сигнал испускается каждый раз, когда обновляются настройки маркера местоположения пользователя на карте.

• userMarker — обновлённые настройки маркера пользователя.

Примечание. Сигнал уведомления для свойства userMarker.

[signal] void MfwMap::zoomLevelChanged(qreal zoomLevel)

Сигнал испускается при изменении уровня масштабирования карты.

Этот сигнал испускается при изменении уровня масштабирования карты.

• zoomLevel — новый уровень масштабирования карты.

Примечание. Сигнал уведомления для свойства zoomLevel.