QGeoServiceProvider Class

멤버 함수 설명서

QGeoServiceProvider::QGeoServiceProvider(const QString &providerName, const QVariantMap &parameters = QVariantMap(), bool allowExperimental = false)

제공된 ` parameters`를 사용하여, 백엔드 이름이 ` providerName`인 `QGeoServiceProvider`를 생성합니다.

여러 플러그인이 동일한 providerName 를 가지는 경우, providerVersion() 값이 가장 높은 플러그인이 사용됩니다.

allowExperimental 가 true인 경우, 실험용으로 표시된 플러그인이 사용될 수 있습니다. 기본적으로 실험용 플러그인은 고려되지 않습니다.

providerName 과 일치하는 플러그인을 로드할 수 없는 경우, error() 및 errorString()가 그 원인에 대한 세부 정보를 제공합니다.

[virtual noexcept] QGeoServiceProvider::~QGeoServiceProvider()

서비스 제공자 객체를 삭제합니다.

[static] QStringList QGeoServiceProvider::availableServiceProviders()

QGeoServiceProvider 생성자와 함께 사용할 수 있는 서비스 제공자의 이름 목록을 반환합니다.

QGeoServiceProvider::Error QGeoServiceProvider::error() const

이 클래스에서 수행된 마지막 작업 중에 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::errorString() const

이 클래스에서 수행된 마지막 작업 중에 발생한 오류를 설명하는 문자열을 반환합니다.

QGeoServiceProvider::Error QGeoServiceProvider::geocodingError() const

지오코딩 관리자를 생성하려는 마지막 시도 중에 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::geocodingErrorString() const

지오코딩 관리자를 생성하려던 마지막 시도 중에 발생한 오류를 설명하는 문자열을 반환합니다.

QGeoServiceProvider::GeocodingFeatures QGeoServiceProvider::geocodingFeatures() const

지오 서비스 제공자가 지원하는 지오코딩 기능을 반환합니다.

QGeoCodingManager *QGeoServiceProvider::geocodingManager() const

서비스 제공자가 제공하는 QGeoCodingManager 를 반환합니다.

서비스 제공자가 지오코딩 서비스를 전혀 제공하지 않는 경우, 이 함수는 ` nullptr `를 반환합니다.

이 함수는 처음 호출될 때 QGeoCodingManager 인스턴스를 생성하려고 시도합니다. 생성 시도가 성공하면 QGeoCodingManager 가 캐시되며, 그렇지 않은 경우 이 함수가 호출될 때마다 생성 시도가 성공할 때까지 QGeoCodingManager 인스턴스를 생성하려고 시도합니다.

QGeoCodingManager 는 이 QGeoServiceProvider 가 소유하고 있으므로 별도로 삭제해서는 안 됩니다. 사용자는 QGeoServiceProvider 를 삭제하면 이 메서드가 반환한 포인터가 무효화된다고 간주해야 합니다.

이 함수가 호출된 후, ` error()` 및 ` errorString()`은 ` QGeoCodingManager` 생성 과정에서 발생한 오류를 보고합니다.

QGeoServiceProvider::Error QGeoServiceProvider::mappingError() const

매핑 관리자를 생성하려던 마지막 시도 중에 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::mappingErrorString() const

매핑 관리자를 생성하려던 마지막 시도 중에 발생한 오류를 설명하는 문자열을 반환합니다.

QGeoServiceProvider::MappingFeatures QGeoServiceProvider::mappingFeatures() const

지오 서비스 제공자가 지원하는 매핑 기능을 반환합니다.

QGeoServiceProvider::Error QGeoServiceProvider::navigationError() const

마지막으로 네비게이션 관리자를 생성하려 했을 때 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::navigationErrorString() const

마지막으로 네비게이션 매니저를 생성하려 했을 때 발생한 오류를 설명하는 문자열을 반환합니다.

[since QtLocation 5.11] QGeoServiceProvider::NavigationFeatures QGeoServiceProvider::navigationFeatures() const

지오 서비스 제공자가 지원하는 내비게이션 기능을 반환합니다.

이 함수는 QtLocation 5.11에서 도입되었습니다.

QPlaceManager *QGeoServiceProvider::placeManager() const

서비스 제공자가 제공하는 QPlaceManager 객체를 반환합니다.

이 함수는 처음 호출될 때 QPlaceManager 인스턴스를 생성하려고 시도합니다. 생성 시도가 성공하면 QPlaceManager 가 캐시에 저장되며, 그렇지 않은 경우 이 함수가 호출될 때마다 생성 시도가 성공할 때까지 QPlace 인스턴스를 생성하려고 시도합니다.

QGeoPlaceManager는 이 QGeoServiceProvider 가 소유하고 있으므로 별도로 삭제해서는 안 됩니다. 사용자는 QGeoServiceProvider 를 삭제하면 이 메서드가 반환한 포인터가 무효화된다고 간주해야 합니다.

이 함수가 호출된 후, ` error()` 및 ` errorString()`는 ` QPlaceManager` 생성 과정에서 발생한 모든 오류를 보고합니다.

QGeoServiceProvider::Error QGeoServiceProvider::placesError() const

장소 관리자를 생성하려던 마지막 시도 중에 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::placesErrorString() const

마지막으로 장소 관리자를 생성하려 했을 때 발생한 오류를 설명하는 문자열을 반환합니다.

QGeoServiceProvider::PlacesFeatures QGeoServiceProvider::placesFeatures() const

지오 서비스 제공자가 지원하는 장소 피처들을 반환합니다.

QGeoServiceProvider::Error QGeoServiceProvider::routingError() const

마지막으로 라우팅 관리자를 생성하려 했을 때 발생한 오류를 설명하는 오류 코드를 반환합니다.

QString QGeoServiceProvider::routingErrorString() const

마지막으로 라우팅 관리자를 생성하려 했을 때 발생한 오류를 설명하는 문자열을 반환합니다.

QGeoServiceProvider::RoutingFeatures QGeoServiceProvider::routingFeatures() const

지오 서비스 제공자가 지원하는 라우팅 기능을 반환합니다.

QGeoRoutingManager *QGeoServiceProvider::routingManager() const

서비스 제공자가 제공하는 지리적 라우팅 서비스( QGeoRoutingManager )를 반환합니다.

서비스 제공자가 지리적 라우팅 서비스를 제공하지 않는 경우, 이 함수는 ` nullptr `를 반환합니다.

이 함수는 처음 호출될 때 QGeoRoutingManager 인스턴스를 생성하려고 시도합니다. 생성 시도가 성공하면 QGeoRoutingManager 이 캐시되며, 그렇지 않은 경우 이 함수가 호출될 때마다 생성 시도가 성공할 때까지 QGeoRoutingManager 인스턴스를 생성하려고 시도합니다.

QGeoRoutingManager 는 이 QGeoServiceProvider 가 소유하고 있으므로 별도로 삭제해서는 안 됩니다. 사용자는 QGeoServiceProvider 를 삭제하면 이 메서드가 반환한 포인터가 무효화된다고 간주해야 합니다.

이 함수가 호출된 후, ` error()` 및 ` errorString()`은 ` QGeoRoutingManager` 생성 과정에서 발생한 모든 오류를 보고합니다.

void QGeoServiceProvider::setAllowExperimental(bool allow)

이 서비스 제공자에 대한 올바른 플러그인 라이브러리를 찾을 때 실험용 플러그인을 고려할지 여부를 allow 에 설정합니다.

중요: 이 메서드를 호출하면 이 서비스 제공자 인스턴스가 보유한 기존 관리자(manager)가 모두 삭제됩니다. 이 메서드를 호출한 후에는 이전에 가져온 포인터를 절대 사용하지 않도록 주의해야 합니다.

void QGeoServiceProvider::setLocale(const QLocale &locale)

이 서비스 제공자가 사용하는 로케일을 locale 로 설정합니다. 관련 기능( LocalizedMappingFeature 등 참조)이 활성화된 경우, 이 설정으로 인해 제공자의 데이터에 포함된 언어, 단위 및 기타 로케일 관련 속성이 변경됩니다.

void QGeoServiceProvider::setParameters(const QVariantMap &parameters)

이 서비스 제공자에 대한 개별 관리자 클래스를 생성하는 데 사용되는 매개변수를 parameters 로 설정합니다.

parameters 목록이 로드될 서비스 제공자에게 전달되기 전에, 관련 없는 서비스 제공자와 제공자별 매개변수가 공유되는 것을 방지하기 위해 목록이 필터링됩니다. 제공자별 매개변수 키에는 제공자 이름이 접두사로 붙어야 합니다(예: here.app_id).

중요: 이 메서드를 호출하면 해당 서비스 제공자 인스턴스가 보유하고 있는 기존 관리자(manager)가 모두 삭제됩니다. 이 메서드를 호출한 후에는 이전에 가져온 포인터를 절대 사용하지 않도록 주의해야 합니다.