QGIS API Documentation 4.1.0-Master (60fea48833c)
Loading...
Searching...
No Matches
qgsgeocoder.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsgeocoder.h
3 ---------------
4 Date : August 2020
5 Copyright : (C) 2020 by Nyall Dawson
6 Email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSGEOCODER_H
17#define QGSGEOCODER_H
18
19#include "qgis_core.h"
20#include "qgsfields.h"
21#include "qgsgeocoderresult.h"
22#include "qgsgeometry.h"
23
24class QgsFeature;
26
36class CORE_EXPORT QgsGeocoderInterface
37{
38 public:
40 enum class Flag SIP_ENUM_BASETYPE( IntFlag )
41 {
42 GeocodesStrings = 1 << 0,
43 GeocodesFeatures = 1 << 1,
44 };
45 Q_DECLARE_FLAGS( Flags, Flag )
46
47 virtual ~QgsGeocoderInterface() = default;
48
52 virtual Flags flags() const = 0;
53
61 virtual QList< QgsGeocoderResult > geocodeFeature( const QgsFeature &feature, const QgsGeocoderContext &context, QgsFeedback *feedback = nullptr ) const;
62
70 virtual QgsFields appendedFields() const;
71
79 virtual Qgis::WkbType wkbType() const;
80
88 virtual QList< QgsGeocoderResult > geocodeString( const QString &string, const QgsGeocoderContext &context, QgsFeedback *feedback = nullptr ) const;
89};
90
91#endif // QGSGEOCODER_H
Provides global constants and enumerations for use throughout the application.
Definition qgis.h:62
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:60
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition qgsfeedback.h:44
Container of fields for a vector layer.
Definition qgsfields.h:46
Encapsulates the context of a geocoding operation.
Interface for geocoders.
Definition qgsgeocoder.h:37
virtual QList< QgsGeocoderResult > geocodeFeature(const QgsFeature &feature, const QgsGeocoderContext &context, QgsFeedback *feedback=nullptr) const
Geocodes a feature.
virtual Flags flags() const =0
Returns the geocoder's capability flags.
Flag
Capability flags for the geocoder.
Definition qgsgeocoder.h:41
virtual Qgis::WkbType wkbType() const
Returns the WKB type of geometries returned by the geocoder.
virtual QList< QgsGeocoderResult > geocodeString(const QString &string, const QgsGeocoderContext &context, QgsFeedback *feedback=nullptr) const
Geocodes a string.
virtual QgsFields appendedFields() const
Returns a set of newly created fields which will be appended to existing features during the geocode ...
QFlags< Flag > Flags
Definition qgsgeocoder.h:45
Represents a matching result from a geocoder search.
#define SIP_ENUM_BASETYPE(type)
Definition qgis_sip.h:274