場所 (C++)

//The "provider name" is used to select a particular provider
QGeoServiceProvider *provider = new QGeoServiceProvider("provider name");
QPlaceManager *manager = provider->placeManager();

//instantiate request and set parameters
QPlaceSearchRequest searchRequest;
searchRequest.setSearchTerm("ice cream");
searchRequest.setSearchArea(QGeoCircle(QGeoCoordinate(12.34, 56.78)));

//send off a search request
/*QPlaceSearchReply * */ searchReply = manager->search(searchRequest);

//connect a slot to handle the reply
connect(searchReply, &QPlaceSearchReply::finished, this, &RequestHandler::handleSearchReply);

voidhandleSearchReply() {
    if(searchReply->error()==QPlaceReply::NoError) {
        for(constQPlaceSearchResult&result: searchReply->results()) {
            if(result.type()==QPlaceSearchResult::PlaceResult) {
                QPlaceResult placeResult=result;
                qDebug() << "Name: " << placeResult.place().name();
                qDebug() << "Coordinate " << placeResult.place().location().coordinate().toString();
                qDebug() << "Street: " << placeResult.place().location().address().street();
                qDebug() << "Distance: " << placeResult.distance();
            }
        }
    }
    searchReply->deleteLater();  // 返信を破棄
    searchReply=nullptr;
}

QPlaceSearchRequest searchRequest;
searchRequest.setLimit(15); //specify how many results are to be retrieved.

if (!place.detailsFetched()) {
    /*QPlaceDetailsReply * */ detailsReply = manager->getPlaceDetails(place.placeId());
    connect(detailsReply, &QPlaceDetailsReply::finished, this, &RequestHandler::handleDetailsReply);
}
    ...
    ...
void handleDetailsReply() {
    QPlace place;
    if (detailsReply->error() == QPlaceReply::NoError)
        place = detailsReply->place();

    detailsReply->deleteLater(); //discard reply
    detailsReply = nullptr;
}

QPlaceContentRequest request;
request.setContentType(QPlaceContent::ImageType);
request.setPlaceId(place.placeId());
request.setLimit(5);
/*QPlaceContentReply * */ contentReply = manager->getPlaceContent(request);
connect(contentReply, &QPlaceContentReply::finished, this, &RequestHandler::handleImagesReply);

voidhandleImagesReply() {
    if(contentReply->error()==QPlaceReply::NoError) {
        const autocontent= contentReply->content();
        for(autoiter=content.cbegin(),end=content.cend(); iter!=end;++iter) {
            qDebug() << "Index: " << iter.key();
           QPlaceImageimage=iter.value();
            qDebug() << image.url();
            qDebug() << image.mimeType();
        }

        // あるいは、インデックスが関係のない場合
        for(const QPlaceImage &image: contentReply->content()) {
            qDebug() << image.url();
            qDebug() << image.mimeType();
        }

        //コンテンツを、それに対応する「place」に割り当てることができます。
        //「place」オブジェクトは、すでに取得済みの
        //コンテンツ を取り出すためのコンテナとして機能します
        place.insertContent(contentReply->request().contentType(), contentReply->content());
        place.setTotalContentCount(contentReply->request().contentType(), contentReply->totalCount());
    }

    contentReply->deleteLater();
    contentReply=nullptr;
}

QPlaceImage image = content; //provided that 'content' has a type QPlace::ImageType

QPlaceSearchRequest request;
request.setSearchTerm("piz");
request.setSearchArea(QGeoCircle(QGeoCoordinate(12.34, 56.78)));
/* QPlaceSearchSuggestion * */suggestionReply = manager->searchSuggestions(request);
connect(suggestionReply, &QPlaceSearchSuggestion::finished, this, &RequestHandler::handleSuggestionReply);

voidhandleSuggestionReply() {
    if(suggestionReply->error()==QPlaceReply::NoError) {
        for(constQString&suggestion: suggestionReply->suggestions())
            qDebug() << suggestion;
    }

    suggestionReply->deleteLater();// 返信を破棄
    suggestionReply=nullptr;
}

QPlace  place;
place.setName( "Fred's Ice Cream Parlor" );

QGeoLocation location;
location.setCoordinate(QGeoCoordinate(12.34, 56.78));

QGeoAddress address;
address.setStreet("111 Nother Street");
    ...
location.setAddress(address);
place.setLocation(location);

/* QPlaceIdReply * */savePlaceReply = manager->savePlace(place);
connect(savePlaceReply, &QPlaceIdReply::finished, this, &RequestHandler::handleSavePlaceReply);

voidhandleSavePlaceReply() {
    if(savePlaceReply->error()==QPlaceReply::NoError)
        qDebug() << savePlaceReply->id();

    savePlaceReply->deleteLater();//返信を破棄
    savePlaceReply=nullptr;
}

//result retrieved from a different manager)
QPlace place = manager->compatiblePlace(result.place());
saveReply = manager->savePlace(place);

/* QPlaceIdReply * */removePlaceReply = manager->removePlace(place.placeId());
connect(removePlaceReply, &QPlaceIdReply::finished, this, &RequestHandler::handleRemovePlaceReply);
    ...
    ...
voidhandleRemovePlaceReply() {
    if(removePlaceReply->error()==QPlaceReply::NoError)
        qDebug() << "Removal of place identified by"
                << removePlaceReply->id()<< "が正常に完了しました";

    removePlaceReply->deleteLater();// 返信を破棄
    removePlaceReply=nullptr;
}

/* QPlaceReply * */initCatReply = manager->initializeCategories();
connect(initCatReply, &QPlaceReply::finished, this, &RequestHandler::handleInitCatReply);
    ...
    ...
voidhandleInitCatReply() {
    if(initCatReply->error()==QPlaceReply::NoError)
        qDebug() << "Categories initialized";
   else
        qDebug() << "Failed to initialize categories";

    initCatReply->deleteLater();
    initCatReply=nullptr;
}

constQList<QPlaceCategory>topLevelCategories= manager->childCategories();
for(constQPlaceCategory&category: topLevelCategories)
    qDebug() << category.name();

QList<QPlaceCategory> childCategories = manager->childCategories(pizza.categoryId());

QPlaceCategory fastFood;

QPlaceCategory category;
category.setName("pizza");
/*QPlaceIdReply */saveCategoryReply= manager->saveCategory(category);
connect(saveCategoryReply, &QPlaceIdReply::finished, this, &RequestHandler::handleSaveCategoryReply);

// 親の識別子を指定することで、カテゴリを子として保存することも可能です。
saveCategoryReply= manager->saveCategory(category,fastFood.categoryId());
    ...
    ...
voidhandleSaveCategoryReply() {
    if(saveCategoryReply->error()==QPlaceReply::NoError) {
        qDebug() << "Saved category id =" << saveCategoryReply->id();
    }

    saveCategoryReply->deleteLater();
    saveCategoryReply=nullptr;
}

/* QPlaceIdReply * */removeCategoryReply = manager->removeCategory(place.placeId());
connect(removeCategoryReply, &QPlaceIdReply::finished, this, &RequestHandler::handleRemoveCategoryReply);
    ...
    ...
voidhandleRemoveCategoryReply() {
    if(removeCategoryReply->error()==QPlaceReply::NoError)
        qDebug() << "Removal of category identified by"
                << removeCategoryReply->id()<< "が正常に完了しました";

    removeCategoryReply->deleteLater();// 返信を破棄
    removeCategoryReply=nullptr;
}

origin R/O manager(here)       destination R/W manager (places_jsondb)
                        Save
Place id: ae246         --->    Place id: 0001
Attribute type: x_provider      Attribute type: x_id_here
Attribute value: here           Attribute text value: ae246

QPlaceMatchRequest request;
request.setResults(results);
QVariantMap parameters;
parameters.insert(QPlaceMatchRequest::AlternativeId, "x_id_here");
request.setParameters(parameters);
matchReply= manager->matchingPlaces(request);
    ...
    ...
voidmatchHandler() {
    if(matchReply->error()==QPlaceReply::NoError) {
        const autoplaces= matchReply->places();
        for(constQPlace&place: places) {
            if(place!=QPlace())
                qDebug() << "Place is a favorite with name" << place.name();
           else
                qDebug() << "Place is not a favorite";
        }
    }

    matchReply->deleteLater();
    matchReply=nullptr;
}