GeoFlickr (QML)#

The GeoFlickr example shows how to use the user’s current position to fetch local content from a web service.

This is a small example, illustrating one of the very core parts of the Qt Positioning API: the ability to retrieve and use the user’s current geographic position.

Key QML types shown in this example:

../_images/qml-flickr-1.jpg

Running the Example#

To run the example from Qt Creator , open the Welcome mode and select the example from Examples. For more information, visit Building and Running an Example.

Retrieving the Current Position#

Retrieving the user’s current position is achieved using the PositionSource type. In this example, we instantiate the PositionSource as part of the GeoTab component (the floating “window” describing current position and status).

PositionSource {
    id: positionSource
    onPositionChanged: { planet.source = "images/sun.png"; }

    onSourceErrorChanged: {
        if (sourceError == PositionSource.UpdateTimeoutError) {
            activityText.fadeOut = true
            return
        }

        if (sourceError == PositionSource.NoError)
            return

        console.log("Source error: " + sourceError)
        activityText.fadeOut = true
        stop()
    }
}

When the “Locate and update” button is pressed, we first interrogate the PositionSource to check if it has an available backend for positioning data. If it does not, we fall back to using a pre-recorded NMEA log for demonstration. We then instruct the PositionSource to request a location update .

Button {
    id: locateButton
    text: "Locate & update"            onClicked: {
        if (positionSource.supportedPositioningMethods ===
                PositionSource.NoPositioningMethods) {
            positionSource.nmeaSource = "nmealog.txt";
            sourceText.text = "(filesource): " + printableMethod(positionSource.supportedPositioningMethods);
        }
        positionSource.update();
    }
}

To share the new position data with the rest of the application, we use properties that we have created on the GeoTab component:

property var coordinate

Using the Current Position#

The longitude and latitude values retrieved here are eventually set in the properties on the RestModel component. The RestModel is an XmlListModel, which retrieves XML data from a URL and creates a data model by parsing it.

In this case, it retrieves data from the Flickr REST API online, based on our current position

XmlListModel {
    property var coordinate

    source: "https://api.flickr.com/services/rest/?" +
            "min_taken_date=2000-01-01+0:00:00&" +
            "extras=date_taken&" +
            "method=flickr.photos.search&" +
            "per_page=30&" +
            "sort=date-taken-desc&" +
            "api_key=e36784df8a03fea04c22ed93318b291c&" +
            "lat=" + coordinate.latitude + "&lon=" + coordinate.longitude;
    query: "/rsp/photos/photo"

    XmlListModelRole { name: "title"; elementName: ""; attributeName: "title" }
    XmlListModelRole { name: "datetaken"; elementName: ""; attributeName: "datetaken" }
    XmlListModelRole { name: "farm"; elementName: ""; attributeName: "farm" }
    XmlListModelRole { name: "server"; elementName: ""; attributeName: "server" }
    XmlListModelRole { name: "id"; elementName: ""; attributeName: "id" }
    XmlListModelRole { name: "secret"; elementName: ""; attributeName: "secret" }
}

This model data is then shown in a variety of Qt Quick views to produce the example application.

Example project @ code.qt.io