Skip to content
  • OrientedImageryLayer
  • class Esri::ArcGISRuntime::OrientedImageryLayer

    A layer that can visualize point feature data with additional properties that support the oriented imagery workflow. More...

    Header: #include <OrientedImageryLayer.h>
    Since: Esri::ArcGISRuntime 300.0
    Inherits: Esri::ArcGISRuntime::Layer and Esri::ArcGISRuntime::PopupSource

    Public Functions

    OrientedImageryLayer(const QUrl &url, QObject *parent = nullptr)
    virtual ~OrientedImageryLayer() override
    void clearSelection()
    Esri::ArcGISRuntime::ArcGISFeatureTable *featureTable() const
    qint64 layerId() const
    void selectFeature(Esri::ArcGISRuntime::Feature *feature)
    void selectFeatures(const QList<Esri::ArcGISRuntime::Feature *> &features)
    QFuture<Esri::ArcGISRuntime::FeatureQueryResult *> selectFeaturesAsync(const Esri::ArcGISRuntime::QueryParameters &parameters, Esri::ArcGISRuntime::SelectionMode mode, QObject *parent = nullptr)
    QFuture<Esri::ArcGISRuntime::FeatureQueryResult *> selectedFeaturesAsync(QObject *parent = nullptr)
    void unselectFeature(Esri::ArcGISRuntime::Feature *feature)
    void unselectFeatures(const QList<Esri::ArcGISRuntime::Feature *> &features)
    QUrl url() const

    Reimplemented Public Functions

    virtual bool isPopupEnabled() const override
    virtual Esri::ArcGISRuntime::PopupDefinition *popupDefinition() const override
    virtual void setPopupDefinition(Esri::ArcGISRuntime::PopupDefinition *popupDefinition) override
    virtual void setPopupEnabled(bool popupEnabled) override

    Static Public Members

    Esri::ArcGISRuntime::OrientedImageryLayer *create(Esri::ArcGISRuntime::ArcGISFeatureTable *featureTable, QObject *parent = nullptr)
    Esri::ArcGISRuntime::OrientedImageryLayer *create(Esri::ArcGISRuntime::PortalItem *portalItem, qint64 layerId, QObject *parent = nullptr)

    Detailed Description

    Oriented imagery enables the use of nontraditional images in ArcGIS as described in the ArcGIS Pro "Introduction to oriented imagery". Each image includes location, orientation, and camera metadata that link image pixels to map locations. Supported imagery includes street-level, mobile, oblique, close-range, and 360-degree images.

    An oriented imagery layer stores the location where each image was acquired, the path to the image file, and the key metadata required to visualize the imagery within a map or scene. The layer is composed of point features representing camera locations, along with attributes that define image metadata and additional information about the real-world feature it represents.

    Member Function Documentation

    [explicit] OrientedImageryLayer::OrientedImageryLayer(const QUrl &url, QObject *parent = nullptr)

    Creates a new oriented imagery layer object with a URL.

    • url - The URL of an individual layer in an ArcGIS map or feature service.
    • parent - The optional parent QObject.

    The layer will fail to load if the specified URL is not a valid oriented imagery layer endpoint. A valid oriented imagery layer is a feature service layer whose type is "Oriented Imagery Layer" and that includes the required oriented imagery metadata in the layer-level orientedImageryInfo property.

    [override virtual noexcept] OrientedImageryLayer::~OrientedImageryLayer()

    Destructor.

    void OrientedImageryLayer::clearSelection()

    Clears the list of selected features and clears the visible selection halos from the map or scene view.

    [static] Esri::ArcGISRuntime::OrientedImageryLayer *OrientedImageryLayer::create(Esri::ArcGISRuntime::ArcGISFeatureTable *featureTable, QObject *parent = nullptr)

    Creates a new oriented imagery layer object from a feature table containing oriented imagery data.

    • featureTable - The feature table containing point features representing camera locations, with attributes that define imagery metadata and camera characteristics.
    • parent - The optional parent QObject.

    If the feature table does not contain oriented imagery data, the layer will fail to load. ArcGISFeatureTable::layerInfo and ArcGISFeatureLayerInfo::serviceType can be checked to verify the feature type before attempting to create a OrientedImageryLayer.

    [static] Esri::ArcGISRuntime::OrientedImageryLayer *OrientedImageryLayer::create(Esri::ArcGISRuntime::PortalItem *portalItem, qint64 layerId, QObject *parent = nullptr)

    Creates a new oriented imagery layer object from a feature service portal item.

    • portalItem - The feature service PortalItem.
    • layerId - The layer id for which to create the layer.
    • parent - The optional parent QObject.

    Esri::ArcGISRuntime::ArcGISFeatureTable *OrientedImageryLayer::featureTable() const

    Returns the feature table associated with the layer.

    [override virtual] bool OrientedImageryLayer::isPopupEnabled() const

    Reimplements: PopupSource::isPopupEnabled() const.

    Returns a flag indicating whether the PopupDefinition defined on the PopupSource is enable / disable.

    Will return false if an error occurs.

    qint64 OrientedImageryLayer::layerId() const

    Returns the layer ID that defines the layer within the feature service portal item.

    [override virtual] Esri::ArcGISRuntime::PopupDefinition *OrientedImageryLayer::popupDefinition() const

    Reimplements: PopupSource::popupDefinition() const.

    Returns the pop-up definition.

    The PopupDefinition associated with the popup source. A nullptr if an error occurs or if the popup source is not associated with a pop-up definition.

    See also setPopupDefinition().

    void OrientedImageryLayer::selectFeature(Esri::ArcGISRuntime::Feature *feature)

    Selects the given feature and adds it to the current list of selected features.

    • feature - The feature to select.

    void OrientedImageryLayer::selectFeatures(const QList<Esri::ArcGISRuntime::Feature *> &features)

    Selects the given features and adds them to the current list of selected features.

    • features - The features to select.

    QFuture<Esri::ArcGISRuntime::FeatureQueryResult *> OrientedImageryLayer::selectFeaturesAsync(const Esri::ArcGISRuntime::QueryParameters &parameters, Esri::ArcGISRuntime::SelectionMode mode, QObject *parent = nullptr)

    Selects the features that match the criteria in the QueryParameters object and adds them to the current list of selected features.

    • parameters - The definition of the query to submit to the feature table.
    • mode - Defines how the list of currently selected features will be updated with the features returned from the query.
    • parent - The optional parent QObject.

    This method returns a QFuture for the asynchronous operation. Use future.then() to continue processing when the operation completes. Use future.onFailed() to handle exceptions of type ErrorException.

    See Working with QFuture for further details.

    QFuture<Esri::ArcGISRuntime::FeatureQueryResult *> OrientedImageryLayer::selectedFeaturesAsync(QObject *parent = nullptr)

    Returns a list of the currently selected features with an optional parent.

    This method returns a QFuture for the asynchronous operation. Use future.then() to continue processing when the operation completes. Use future.onFailed() to handle exceptions of type ErrorException.

    See Working with QFuture for further details.

    [override virtual] void OrientedImageryLayer::setPopupDefinition(Esri::ArcGISRuntime::PopupDefinition *popupDefinition)

    Reimplements: PopupSource::setPopupDefinition(Esri::ArcGISRuntime::PopupDefinition *popupDefinition).

    Sets the popupDefinition to popupDefinition.

    See also popupDefinition.

    [override virtual] void OrientedImageryLayer::setPopupEnabled(bool popupEnabled)

    Reimplements: PopupSource::setPopupEnabled(bool popupEnabled).

    Sets the popupEnabled to popupEnabled.

    See also isPopupEnabled.

    void OrientedImageryLayer::unselectFeature(Esri::ArcGISRuntime::Feature *feature)

    Unselects the given feature and removes it from the current list of selected features.

    • feature - The feature to be unselected.

    void OrientedImageryLayer::unselectFeatures(const QList<Esri::ArcGISRuntime::Feature *> &features)

    Unselects the given features and removes them from the current list of selected features.

    • features - The features to be unselected.

    QUrl OrientedImageryLayer::url() const

    Returns the URL of the oriented imagery layer.

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.