File: qgsserverapiutils.sip.in

package info (click to toggle)
qgis 3.40.10%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 1,183,672 kB
  • sloc: cpp: 1,595,771; python: 372,544; xml: 23,474; sh: 3,761; perl: 3,664; ansic: 2,257; sql: 2,137; yacc: 1,068; lex: 577; javascript: 540; lisp: 411; makefile: 161
file content (176 lines) | stat: -rw-r--r-- 5,659 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/server/qgsserverapiutils.h                                       *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/








class QgsServerApiUtils
{
%Docstring(signature="appended")
The :py:class:`QgsServerApiUtils` class contains helper functions to
handle common API operations.

.. versionadded:: 3.10
%End

%TypeHeaderCode
#include "qgsserverapiutils.h"
%End
  public:
    static QgsRectangle parseBbox( const QString &bbox );
%Docstring
Parses a comma separated ``bbox`` into a (possibly empty)
:py:class:`QgsRectangle`.

.. note::

   Z values (i.e. a 6 elements bbox) are silently discarded
%End

    static QList<QgsServerWmsDimensionProperties::WmsDimensionInfo> temporalDimensions( const QgsVectorLayer *layer );
%Docstring
Returns a list of temporal dimensions information for the given
``layer`` (either configured in wmsDimensions or the first date/datetime
field)

.. versionadded:: 3.12
%End

    static QgsDateRange parseTemporalDateInterval( const QString &interval ) throw( QgsServerApiBadRequestException );
%Docstring
Parses a date ``interval`` and returns a :py:class:`QgsDateRange`

:raises QgsServerApiBadRequestException: if interval cannot be parsed

.. versionadded:: 3.12
%End

    static QgsDateTimeRange parseTemporalDateTimeInterval( const QString &interval ) throw( QgsServerApiBadRequestException );
%Docstring
Parses a datetime ``interval`` and returns a
:py:class:`QgsDateTimeRange`

:raises QgsServerApiBadRequestException: if interval cannot be parsed

.. versionadded:: 3.12
%End


    static QString fieldName( const QString &name, const QgsVectorLayer *layer ) throw( QgsServerApiBadRequestException );
%Docstring
Given a field ``name`` (or display name) and a ``layer`` returns the
actual name of the field.

:raises QgsServerApiBadRequestException: if ``name`` is neither a field
                                         name or a display name.

.. versionadded:: 3.28
%End



    static QgsExpression temporalFilterExpression( const QgsVectorLayer *layer, const QString &interval );
%Docstring
Parses the ``interval`` and constructs a (possibly invalid) temporal
filter expression for the given ``layer``

Interval syntax:

interval-closed = date-time "/" date-time interval-open-start = [".."]
"/" date-time interval-open-end = date-time "/" [".."] interval =
interval-closed / interval-open-start / interval-open-end datetime =
date-time / interval

.. versionadded:: 3.12
%End



    static QVariantList temporalExtentList( const QgsVectorLayer *layer ) /PyName=temporalExtent/;
%Docstring
temporalExtent returns a json array with an array of [min, max] temporal
extent for the given ``layer``. In case multiple temporal dimensions are
available in the layer, a union of all dimensions is returned.

From specifications:
http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/extent.yaml

One or more time intervals that describe the temporal extent of the
dataset. The value `null` is supported and indicates an open time
interval.

In the Core only a single time interval is supported. Extensions may
support multiple intervals. If multiple intervals are provided, the
union of the intervals describes the temporal extent.

:return: An array of intervals

.. versionadded:: 3.12
%End

    static QgsCoordinateReferenceSystem parseCrs( const QString &bboxCrs );
%Docstring
Parses the CRS URI ``bboxCrs`` (example:
"http://www.opengis.net/def/crs/OGC/1.3/CRS84") into a QGIS CRS object
%End

    static const QVector<QgsVectorLayer *> publishedWfsLayers( const QgsServerApiContext &context );
%Docstring
Returns the list of layers accessible to the service for a given
``context``.

This method takes into account the ACL restrictions provided by QGIS
Server Access Control plugins.
%End



    static QString sanitizedFieldValue( const QString &value );
%Docstring
Sanitizes the input ``value`` by removing URL encoding.

.. note::

   the returned value is meant to become part of a :py:class:`QgsExpression` filter
%End

    static QStringList publishedCrsList( const QgsProject *project );
%Docstring
Returns the list of CRSs (format:
http://www.opengis.net/def/crs/OGC/1.3/CRS84) available for this
``project``. Information is read from project WMS configuration.
%End

 static QString crsToOgcUri( const QgsCoordinateReferenceSystem &crs ) /Deprecated/;
%Docstring
Returns a ``crs`` as OGC URI (format:
http://www.opengis.net/def/crs/OGC/1.3/CRS84) Returns an empty string on
failure.

.. deprecated:: 3.30

   Use :py:func:`QgsCoordinateReferenceSystem.toOgcUri()` instead.
%End

    static QString appendMapParameter( const QString &path, const QUrl &requestUrl );
%Docstring
Appends MAP query string parameter from current ``requestUrl`` to the
given ``path``
%End
};
/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/server/qgsserverapiutils.h                                       *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.py again   *
 ************************************************************************/