Add documentation for Place

diff --git a/docs/v2_models.rst b/docs/v2_models.rst
index fc702f789a12de0f443a56dac2acb5a3ab6bb312..f8e1b9c0b212edee7098253fb1a5d3ff8366264c 100644 (file)
--- a/docs/v2_models.rst
+++ b/docs/v2_models.rst
@@ -18,9 +18,10 @@ Models
 
 .. autoclass:: Media()
 
-.. class:: tweepy.Place
+:class:`Place`
+==============
 
-   :reference: https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/place
+.. autoclass:: Place()
 
 .. class:: tweepy.Poll
 

diff --git a/tweepy/place.py b/tweepy/place.py
index 6b9d08fbcf3e9a7c703f6c5c05b75467fd4c09b5..43061232fa0e19bb1a1b75e05a9ca267e7e38c9c 100644 (file)
--- a/tweepy/place.py
+++ b/tweepy/place.py
@@ -6,6 +6,44 @@ from tweepy.mixins import DataMapping, HashableID
 
 
 class Place(HashableID, DataMapping):
+    """The place tagged in a Tweet is not a primary object on any endpoint, but
+    can be found and expanded in the Tweet resource. 
+
+    The object is available for expansion with ``?expansions=geo.place_id`` to
+    get the condensed object with only default fields. Use the expansion with
+    the field parameter: ``place.fields`` when requesting additional fields to
+    complete the object.
+
+    .. versionadded:: 4.0
+
+    Attributes
+    ----------
+    data : dict
+        The JSON data representing the place.
+    full_name : str
+        A longer-form detailed place name.
+    id : str
+        The unique identifier of the expanded place, if this is a point of
+        interest tagged in the Tweet.
+    contained_within : list | None
+        Returns the identifiers of known places that contain the referenced
+        place.
+    country : str | None
+        The full-length name of the country this place belongs to.
+    country_code : str | None
+        The ISO Alpha-2 country code this place belongs to.
+    geo : dict | None
+        Contains place details in GeoJSON format.
+    name : str | None
+        The short name of this place.
+    place_type : str | None
+        Specified the particular type of information represented by this place
+        information, such as a city name, or a point of interest.
+
+    References
+    ----------
+    https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/place
+    """
 
     __slots__ = (
         "data", "full_name", "id", "contained_within", "country",