diff options
Diffstat (limited to 'src/location/doc/src/place-definition.qdocinc')
-rw-r--r-- | src/location/doc/src/place-definition.qdocinc | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/src/location/doc/src/place-definition.qdocinc b/src/location/doc/src/place-definition.qdocinc new file mode 100644 index 00000000..d9bcc6b7 --- /dev/null +++ b/src/location/doc/src/place-definition.qdocinc @@ -0,0 +1,27 @@ +A place is a point of interest, it could be a favorite restaurant, a park or someone's home. +A QPlace object represents a place by acting as a container for various information about that place. + +This information can be divided into 2 broad classifications + +\list +\li Details +\li Rich content +\endlist + +The place details consist of properties of the place, such as the name, +location, contact information and so on. When a place is returned during a +search, these details are filled in. Sometimes in order to save bandwidth, +there are further details about the place that can be retrieved on an +individual place by place basis, if the user is interested. The +QPlace::detailsFetched() function can be queried to see if all available +details have been fetched, and if not, QPlaceManager::getPlaceDetails() can +be used to retrieve them. Precisely which details are populated during a +search and which need to be fetched individually may vary from provider to +provider. See \l {Qt Location Module#Plugin References and Parameters}{plugin documentation} for +more details. + +The rich content of a place consists of items such as images, reviews and +editorials. Potentially there may be many rich content items, so they are +treated separately from the place details. They can be retrieved in a paged +fashion via QPlaceManager::getPlaceContent(). If necessary, the content may +be assigned to a place so it can act as a convenient container. |