QGeoCodingManager Class

멤버 함수 문서

[virtual noexcept] QGeoCodingManager::~QGeoCodingManager()

이 관리자를 파괴합니다.

[signal] void QGeoCodingManager::errorOccurred(QGeoCodeReply *reply, QGeoCodeReply::Error error, const QString &errorString = QString())

이 신호는 reply 처리 중 오류가 감지되었을 때 발생합니다. QGeoCodingManager::finished() 신호가 뒤따를 수 있습니다.

오류는 오류 코드 error 로 설명됩니다. errorString 이 비어 있지 않으면 오류에 대한 텍스트 설명이 포함됩니다.

이 신호와 QGeoCodeReply::errorOccurred() 신호가 동시에 전송됩니다.

[signal] void QGeoCodingManager::finished(QGeoCodeReply *reply)

이 신호는 reply 처리가 완료되면 전송됩니다.

reply::error()가 QGeoCodeReply::NoError 와 같으면 처리가 성공적으로 완료된 것입니다.

이 신호와 QGeoCodeReply::finished()가 동시에 전송됩니다.

QGeoCodeReply *QGeoCodingManager::geocode(const QGeoAddress &address, const QGeoShape &bounds = QGeoShape())

address 의 지오코딩을 시작합니다. 지오코딩은 주어진 주소에 해당하는 좌표를 찾는 프로세스입니다.

지오코딩 작업을 관리하고 작업 결과를 반환하는 데 사용할 수 있는 QGeoCodeReply 객체가 반환됩니다.

이 관리자와 반환된 QGeoCodeReply 객체는 작업이 완료되거나 오류가 발생하면 이를 나타내는 신호를 보냅니다.

supportsGeocoding()이 false를 반환하면 QGeoCodeReply::UnsupportedOptionError 이 발생합니다.

작업이 완료되면 QGeoCodeReply::locations()를 사용하여 QGeoLocation 객체 목록으로 구성된 결과를 검색할 수 있습니다. 이러한 객체는 좌표와 주소 데이터의 조합을 나타냅니다.

결과에 반환되는 주소 데이터는 address 과 다를 수 있습니다. 이는 일반적으로 지오코딩 서비스 백엔드에서 다른 표준 주소 형식을 사용하거나 address 이 부분적으로만 채워진 경우에 발생합니다.

bounds 이 null이 아니고 유효한 QGeoShape 인 경우 bounds 에 포함된 결과로 제한하는 데 사용됩니다. address 이 부분적으로만 채워진 경우 서비스가 지정된 데이터에 대한 모든 일치 항목을 지오코딩하려고 시도하므로 특히 유용합니다.

반환된 회신 개체를 삭제할 책임은 사용자에게 있지만, QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() 또는 QGeoCodeReply::errorOccurred()에 연결된 슬롯에서 deleteLater()를 사용하여 삭제할 수 있습니다.

QGeoCodeReply *QGeoCodingManager::geocode(const QString &address, int limit = -1, int offset = 0, const QGeoShape &bounds = QGeoShape())

address 와 일치하는 위치에 대한 지오코딩을 시작합니다.

QGeoCodeReply 객체가 반환되며, 이 객체는 지오코딩 작업을 관리하고 작업 결과를 반환하는 데 사용할 수 있습니다.

이 관리자와 반환된 QGeoCodeReply 객체는 작업이 완료되거나 오류가 발생하면 이를 나타내는 신호를 보냅니다.

작업이 완료되면 QGeoCodeReply::locations()를 사용하여 QGeoLocation 객체 목록으로 구성된 결과를 검색할 수 있습니다. 이러한 객체는 좌표와 주소 데이터의 조합을 나타냅니다.

limit 이 -1이면 전체 결과 집합이 반환되고, 그렇지 않으면 최대 limit 결과만 반환됩니다.

offset 매개변수는 지오코딩 서비스에 첫 번째 offset 결과를 반환하지 않도록 요청하는 데 사용됩니다.

limit 및 offset 결과는 페이징을 구현하는 데 함께 사용됩니다.

bounds 가 null이 아니고 유효한 QGeoShape 인 경우 bounds 에 포함된 결과로 제한하는 데 사용됩니다.

반환된 응답 객체를 삭제할 책임은 사용자에게 있지만 QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() 또는 QGeoCodeReply::errorOccurred()에 연결된 슬롯에서 deleteLater()를 사용하여 삭제할 수 있습니다.

QLocale QGeoCodingManager::locale() const

결과에 사용할 언어에 대해 이 지오코딩 관리자에게 힌트를 주는 데 사용되는 로캘을 반환합니다.

setLocale()도 참조하세요 .

QString QGeoCodingManager::managerName() const

이 지오코딩 매니저의 동작을 구현하는 엔진의 이름을 반환합니다.

managerName()과 managerVersion()의 조합은 플러그인 구현 간에 고유해야 합니다.

int QGeoCodingManager::managerVersion() const

이 지오코딩 매니저의 동작을 구현하는 엔진 버전을 반환합니다.

managerName()와 managerVersion()의 조합은 플러그인 구현 간에 고유해야 합니다.

QGeoCodeReply *QGeoCodingManager::reverseGeocode(const QGeoCoordinate &coordinate, const QGeoShape &bounds = QGeoShape())

coordinate 의 역지오코딩을 시작합니다. 역지오코딩은 주어진 좌표에 해당하는 주소를 찾는 프로세스입니다.

역지오코딩 작업을 관리하고 작업 결과를 반환하는 데 사용할 수 있는 QGeoCodeReply 객체가 반환됩니다.

이 관리자와 반환된 QGeoCodeReply 객체는 작업이 완료되거나 오류가 발생하면 이를 나타내는 신호를 보냅니다.

supportsReverseGeocoding()이 false를 반환하면 QGeoCodeReply::UnsupportedOptionError 이 발생합니다.

이때 QGeoCodeReply::locations()를 사용하여 QGeoLocation 객체 목록으로 구성된 결과를 검색할 수 있습니다. 이러한 객체는 좌표 데이터와 주소 데이터의 조합을 나타냅니다.

결과에 반환되는 좌표 데이터는 coordinate 과 다를 수 있습니다. 이는 일반적으로 역지오코딩 서비스 백엔드에서 좌표를 일치하는 주소에 더 가깝게 이동하거나 백엔드에서 여러 세부 수준의 결과를 반환하는 경우에 발생합니다.

역지오코딩 서비스 백엔드에서 여러 개의 결과를 반환하는 경우 특정성 순서대로 제공됩니다. 이는 일반적으로 백엔드가 여러 세부 수준에서 역지오코딩하도록 구성된 경우에 발생합니다. 예를 들어 일부 서비스는 주소, 도시, 주 및 국가에 대한 주소와 좌표 쌍을 반환합니다.

bounds 가 null이 아니고 유효한 QGeoRectangle 인 경우 bounds 에 포함된 결과로 제한하는 데 사용됩니다.

반환된 회신 개체를 삭제할 책임은 사용자에게 있지만, QGeoCodingManager::finished(), QGeoCodingManager::errorOccurred(), QGeoCodeReply::finished() 또는 QGeoCodeReply::errorOccurred()에 연결된 슬롯에서 deleteLater()를 사용하여 삭제할 수 있습니다.

void QGeoCodingManager::setLocale(const QLocale &locale)

이 관리자가 사용할 로캘을 locale 로 설정합니다.

이 지오코딩 관리자가 다른 언어로 결과 반환을 지원하는 경우 locale 의 언어로 반환됩니다.

이 로캘을 설정하지 않으면 기본적으로 시스템 로캘이 사용됩니다.

locale()도 참조하세요 .