Merge remote-tracking branch 'remotes/origin/0.2.x'

# Conflicts:
#	pyql/interface.py

docs/geo_examples.rst

@@ -28,7 +28,8 @@ Enlistar todos los Continentes
 Obtener un Continente en específico
 ***********************************
 
-Iniciamos un nuevo objeto pero en esta ocasión utilizaremos la función `get` la cual nos devuelve solamente un objeto y no una lista::
+Iniciamos un nuevo objeto pero en esta ocasión utilizaremos la función `get` la cual nos devuelve solamente un objeto
+y no una lista::
 
     continent = Continent.get(name="Africa")
 
@@ -71,3 +72,109 @@ Podemos de igual manera pasar una parte del nombre del lugar y obtener el mismo
     print(find.name)
     print(find.line1)
     print(find.line2)
+
+
+Oceans
+######
+
+Para poder completar estos ejemplos es necesario importar el objeto tipo `Ocean`::
+
+    from pyql.geo.oceans import Ocean
+
+
+Obtener el listado completo de océanos
+**************************************
+
+Obtener todos los océanos e imprimir sus números `woeid`::
+
+    oceans = Ocean.filter()
+    for ocean in oceans:
+        info = "{0}, woeid: {1}".format(ocean.name, ocean.woeid)
+        print(info)
+
+El resultado sería el siguiente::
+
+    Atlantic Ocean, woeid: 55959709
+    Southern Ocean, woeid: 55959676
+    Indian Ocean, woeid: 55959675
+    Pacific Ocean, woeid: 55959717
+    Arctic Ocean, woeid: 55959707
+
+
+Obtener la información de un océano en específico:
+**************************************************
+
+Para obtener solamente un objeto del tipo `Ocean` se requiere utilizar la función `get` seguida de los criterios
+de búsqueda::
+
+    ocean = Ocean.get(name="Atlantic Ocean")
+
+    print(ocean.name)
+    print(ocean.woeid)
+    print(ocean.lang)
+
+States
+######
+
+1. Para poder consultar los estados de una región, es requisito construir el objeto pasando como argumento la
+llave "place" la cual es el nombre del País que deseamos conocer.
+
+2. Para poder completar estos ejemplos es necesario importar el objeto tipo `State`::
+
+    from pyql.geo.states import State
+
+
+Obtener todos los estados de México
+***********************************
+
+Generamos la consulta con el place "Mexico" e imprimimos el resultado en un ciclo for::
+
+    states = State.filter(place="Mexico")
+    for state in states:
+        print(state.name)
+
+La salida del script anterior sería similar a lo siguiente::
+
+
+    Zacatecas
+    Aguascalientes
+    San Luis Potosi
+    Nuevo Leon
+    Durango
+    Guanajuato
+    Nayarit
+    Jalisco
+    Tamaulipas
+    Queretaro de Arteaga
+    Coahuila de Zaragoza
+    Hidalgo
+    Michoacan de Ocampo
+    Mexico
+    Colima
+    Distrito Federal
+    Sinaloa
+    Tlaxcala
+    Morelos
+    Puebla
+    Veracruz-Llave
+    Chihuahua
+    Guerrero
+    Oaxaca
+    Baja California Sur
+    Tabasco
+    Sonora
+    Chiapas
+    Campeche
+    Yucatan
+    Baja California
+    Quintana Roo
+
+Obtener información del estado de Yucatán, México
+*************************************************
+
+Para este ejemplo utilizamos la función `get` en lugar de `filter` para que el resultado sea solamente un objeto
+y no necesiten recorrerlo en un ciclo::
+
+    state = State.get(place="Mexico", name="Yucatan")
+    print(state.name, state.woeid)
+

docs/installation.rst

@@ -7,14 +7,14 @@ Instalación
 
 pyql-weather está escrita 100% en Python puro y por tal motivo no se requiere de ninguna otra dependencia.
 
-Instalarlo es muy fácil:
+Instalarlo es muy fácil::
 
     $ pip install pyql-weather
 
-O también puedes descargarlo directamente desde github en este link:
+O también puedes descargarlo directamente desde github en este link::
 
     https://github.com/alexdzul/pyql-weather/tree/0.2.x
 
-y después ejecutar el script de instalación:
+y después ejecutar el script de instalación::
 
     $ python setup.py install