Place QML Type

Place（場所）タイプは、関心のある位置である場所を表す。詳細...

• 継承メンバを含む全メンバ一覧

プロパティ

• attribution : string
• categories : list<Category>
• contactDetails : ContactDetails
• detailsFetched : bool
• editorialModel : EditorialModel
• extendedAttributes : ExtendedAttributes
• favorite : Place
• icon : Icon
• imageModel : ImageModel
• location : QtPositioning::Location
• name : string
• placeId : string
• plugin : Plugin
• primaryEmail : string
• primaryFax : string
• primaryPhone : string
• primaryWebsite : string
• ratings : Ratings
• reviewModel : ReviewModel
• status : enumeration
• supplier : Supplier
• visibility : enumeration

メソッド

• void copyFrom(Place original)
• string errorString()
• void getDetails()
• void initializeFavorite(Plugin destinationPlugin)
• void remove()
• void save()

詳細説明

Place型は、物理的な場所を、その場所を説明する付加的なメタデータとともに表す。Location 、Address 、coordinate と対照的である。場所の基本特性はname とlocation である。

場所オブジェクトは通常検索モデルから取得され、一般的に基本プロパティのみが設定される。detailsFetched プロパティは、Plugin からさらにプロパティ値を取得する必要があるかどうかをテストするために使用できます。これは、getDetails() メソッドを呼び出すことで実行できます。フェッチ操作の進行状況はstatus プロパティで監視することができ、詳細がフェッチされているときは Place.Fetching に設定されます。

Place型は、場所に関する情報を保持する多くのプロパティを持っています。場所への連絡方法の詳細は、contactDetails プロパティから入手できます。プライマリphone 、fax 、email 、website を取得するための便利なプロパティもあります。

各場所には、0個以上のcategories が割り当てられる。カ テ ゴ リ は通常、 レ ス ト ラ ン やホ テ ル な ど 、 特定の種類の場所を検索す る と き に用い ら れます。いくつかの場所は、ratings オブジェクトを持ち、場所の質の指標を与える。

場所のメタデータは、supplier によって提供される。 は、場所の詳細が表示されるときに、attribution メッセージをユーザーに表示することを要求するかもしれない。

プレイスは、マップ上でプレイスを表現したり、ビューでデリゲートを装飾するために使用できる、関連するicon 。

場所は、それらに関連する追加のリッチコンテンツを持つことができます。現在サポートされているリッチコンテンツには、編集者の説明、レビュー、画像が含まれます。これらはコンテンツを取得するための一連のモデルとして公開されています。場所の編集説明はeditorialModel プロパティから利用できます。その場所のレビューは、reviewModel プロパティから入手できます。場所の写真のギャラリーは、imageModel プロパティを使ってアクセスできます。

場所は、正式なAPIでカバーされていない追加の属性を持つかもしれません。extendedAttributes 。利用可能な拡張属性のタイプは、各Plugin に固有です。

plugin save （）、 （）、 （）を呼び出す前に、 プロパティが設定されていなければなりません。 、 、 は、 プロパティが設定されて初めて有効になります。remove getDetails plugin reviewModel imageModel editorialModel plugin

場所の保存

Plugin がサポートしていれば、「場所」タイプを使って場所を保存することができます。まず、新しい場所を作成し、そのプロパティを設定します：

Place {
    id: myPlace
    plugin: myPlugin

    name: "Brisbane Technology Park"
    location: Location {
        address: Address {
            street: "53 Brandl Street"
            city: "Eight Mile Plains"
            postalCode: "4113"
            country: "Australia"
        }
        coordinate {
            latitude: -27.579646
            longitude: 153.100308
        }
    }

    visibility: Place.PrivateVisibility
}

次にsave() メソッドを呼び出します：

    myPlace.save();

status プロパティはPlace.Savingに変わり、保存が成功すればPlace.Readyに、エラーが発生すればPlace.Errorに変わります。

placeId プロパティが設定されていれば、バックエンドは既存の場所を更新し、そうでなければ新しい場所を作成します。成功すると、placeId プロパティが新しく保存された場所の識別子で更新されます。

注意事項

Places API は現在、core の詳細のみを保存するように設計されています。画像やレビューのようなリッチコンテンツや、サプライヤーや評価のような詳細を保存することはサポートされていません。通常、管理者は保存時にこれらのフィールドを無視します。

Places APIは、以下のコアな詳細の保存のみをサポートしています：

• 名前
• 場所ID
• 場所
• 連絡先の詳細
• アイコン
• カテゴリー（場所を説明するタグのような名前）
• 可視性の範囲

プロバイダがこれらのサブセットしかサポートしていない可能性もあります。詳しくはプラグインのドキュメントをご覧ください。

レーティング、拡張属性、画像、レビュー、社説、サプライヤーなどのプロパティの保存は、Places APIではサポートされていません。

プラグイン間の保存

Placesをプラグイン間で保存する場合、いくつか注意すべき点があります。id、カテゴリ、アイコンのようないくつかのフィールドはプラグイン固有のものです。例えば、あるマネージャのカテゴリは別のマネージャでは認識されないかもしれません。そのため、あるプラグインから別のプラグインに直接プレースメントを保存することはできません。

一般的に、プラグインをまたいだ保存は、Favoritesセクションで説明したように、favorites 。しかし、新しい場所を作成し、その（保存先の）プラグインを設定し、copyFrom （）メソッドを使って元の場所の詳細をコピーするという方法もあります。copyFrom() を使用すると、コピー先のプラグインでサポートされているデータのみがコピーされ、場所の識別子などのプラグイン固有のデータはコピーされません。コピーが完了すると、その場所は保存に適した状態になります。

次のスニペットは、copyFrom メソッドを使って場所を別のプラグインに保存する例です：

var place = Qt.createQmlObject('import QtLocation; Place { }', parent);
place.plugin = destinationPlugin;
place.copyFrom(originalPlace);
place.save();

場所の削除

場所を削除するには、有効なplaceId プロパティを持つ Place オブジェクトが存在することを確認し、そのremove() メソッドを呼び出します。status プロパティは、Place.Removing に変更され、保存に成功した場合は Place.Ready に、エラーが発生した場合は Place.Error に変更されます。

お気に入り

Places APIはお気に入りの概念をサポートしています。お気に入りは一般的に2つのプラグインを使って実装されます。1つ目のプラグインは通常、場所の読み込み専用のソース(オリジンプラグイン)で、2つ目の読み込み/書き込みプラグイン(デスティネーションプラグイン)は、オリジンからの場所をお気に入りとして保存するために使用されます。

各プレイスは、デスティネーションプラグインから対応するプレイスを含むことを意図したお気に入りプロパティを持っています（プレイス自体はオリジンプラグインから取得されます）。元の場所とお気に入りのインスタンスの両方が利用できるため、開発者はユーザーに表示するプロパティを選択することができます。例えば、お気に入りには元の名前ではなく、変更された名前を表示させることができます。

Text { text: place.favorite ? place.favorite.name : place.name }

以下では、お気に入りのインスタンスを保存する方法を説明します。お気に入りのインスタンスを作成/初期化し、保存します。

place.initializeFavorite(destinationPlugin);
//if necessary customizations to the favorite can be made here.
//...
place.favorite.save();

お気に入りの削除

place.favorite.remove();
    ...
//check successful removal of the favorite by monitoring its status.
//once that is done we can assign null to the favorite
place.favorite = null;

PlaceSearchModel には、favoritesPluginプロパティがあります。favoritesPluginプロパティが設定されている場合、検索で見つかったお気に入りの場所がfavoritesPluginと照合され、対応するお気に入りの場所があるかどうかが確認される。お気に入りがあれば、その場所の favorite プロパティが設定され、なければ null のままです。

PlaceSearchModelも参照してください 。

プロパティの説明

    place.plugin = myPlugin;
    place.placeId = "known-place-id";
    place.getDetails();

    var primaryEmail;
    if (place.contactDetails["email"].length > 0)
        primaryEmail = place.contactDetails["email"][0].value;

    var primaryFax;
    if (place.contactDetails["fax"].length > 0)
        primaryFax = place.contactDetails["fax"][0].value;

    var primaryPhone;
    if (place.contactDetails["phone"].length > 0)
        primaryPhone = place.contactDetails["phone"][0].value;

    var primaryWebsite;
    if (place.contactDetails["website"].length > 0)
        primaryWebsite = place.contactDetails["website"][0].value;

place.statusChanged.connect(statusChangedHandler);
    ...
function statusChangedHandler() {
    if (statusChangedHandler.prevStatus === Place.Saving) {
        switch (place.status) {
        case Place.Ready:
            console.log('Save successful');
            break;
        case Place.Error:
            console.log('Save failed');
            break;
        default:
            break;
        }
    }
    statusChangedHandler.prevStatus = place.status;
}

メソッド・ドキュメント