QGeoServiceProviderFactory Class
QGeoServiceProviderFactory 클래스는 지리 정보 관련 서비스의 플러그인 인터페이스로 사용되는 팩토리 클래스입니다. 더 보기...
| Header: | #include <QGeoServiceProviderFactory> |
| qmake: | QT += location |
| Status: | Deprecated |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 함수
| virtual | ~QGeoServiceProviderFactory() |
| virtual QGeoCodingManagerEngine * | createGeocodingManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const |
| virtual QPlaceManagerEngine * | createPlaceManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const |
| virtual QGeoRoutingManagerEngine * | createRoutingManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const |
| virtual void | setQmlEngine(QQmlEngine *engine) |
상세 설명
참고: 백엔드 클래스에 대해서는 소스 또는 바이너리 호환성이보장되지 않습니다 . API는 개발 시 사용된 Qt 버전에서만 작동이 보장됩니다. 단, API 변경은 마이너 릴리스(6.6, 6.7 등)에서만 이루어집니다.
구현자는 플러그인마다 providerName()과 providerVersion()의 고유한 조합을 제공해야 합니다.
플러그인이 관련 기능 세트를 지원하는 경우 다른 함수들은 재정의되어야 합니다.
멤버 함수 설명
[virtual noexcept] QGeoServiceProviderFactory::~QGeoServiceProviderFactory()
이 QGeoServiceProviderFactory 인스턴스를 삭제합니다.
[virtual] QGeoCodingManagerEngine *QGeoServiceProviderFactory::createGeocodingManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const
위치 지오코딩 기능을 구현하는 ` parameters`로 초기화된 새로운 ` QGeoCodingManagerEngine ` 인스턴스를 반환합니다.
error 가 nullptr 가 아닌 경우, 성공 시 QGeoServiceProvider::NoError 로, 실패 시 적절한 QGeoServiceProvider::Error 로 설정해야 합니다.
errorString 가 nullptr 가 아닌 경우, 발생한 오류를 설명하는 문자열로 설정해야 합니다.
기본 구현은 nullptr 를 반환하며, 이로 인해 QGeoServiceProvider 에서 QGeoServiceProvider::NotSupportedError 가 발생합니다.
[virtual] QPlaceManagerEngine *QGeoServiceProviderFactory::createPlaceManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const
위치 검색 기능을 구현하는 ` parameters`로 초기화된 새로운 ` QPlaceManagerEngine ` 인스턴스를 반환합니다.
error 가 nullptr 와 다를 경우, 성공 시에는 QGeoServiceProvider::NoError 로, 실패 시에는 적절한 QGeoServiceProvider::Error 로 설정되어야 합니다.
errorString 가 nullptr 가 아닌 경우, 발생한 오류를 설명하는 문자열로 설정되어야 합니다.
기본 구현은 nullptr 를 반환하며, 이로 인해 QGeoServiceProvider 에서 QGeoServiceProvider::NotSupportedError 이 발생합니다.
[virtual] QGeoRoutingManagerEngine *QGeoServiceProviderFactory::createRoutingManagerEngine(const QVariantMap ¶meters, QGeoServiceProvider::Error *error, QString *errorString) const
parameters 으로 초기화된, 라우팅 기능을 구현하는 새로운 QGeoRoutingManagerEngine 인스턴스를 반환합니다.
error 가 nullptr 와 다를 경우, 성공 시에는 QGeoServiceProvider::NoError 로, 실패 시에는 적절한 QGeoServiceProvider::Error 로 설정되어야 합니다.
errorString 가 nullptr 가 아닌 경우, 발생한 오류를 설명하는 문자열로 설정되어야 합니다.
기본 구현은 nullptr 를 반환하며, 이로 인해 QGeoServiceProvider 에서 QGeoServiceProvider::NotSupportedError 가 발생합니다.
[virtual] void QGeoServiceProviderFactory::setQmlEngine(QQmlEngine *engine)
qml engine 가 준비되면 플러그인에 알립니다. 이때 플러그인은 이를 사용하여 이미지 제공자를 등록할 수 있습니다.
기본 구현은 아무 작업도 수행하지 않습니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
