Combine field & location functions

Author: ipapi-co

README.md

@@ -7,6 +7,7 @@
 pip install ipapi
 ```
 or
+
 ```
 python setup.py install
 ```
@@ -22,27 +23,27 @@ ipapi.location()
 # Gets complete location for your IP address
 {u'city': u'Wilton', u'ip': u'50.1.2.3', u'region': u'California', u'longitude': -121.2429, u'country': u'US', u'latitude': 38.3926, u'timezone': u'America/Los_Angeles', u'postal': u'95693'}
 
-ipapi.field('ip')
+ipapi.location(None, None, 'ip')
 # Gets my external IP address
 u'50.1.2.3'
 
-ipapi.field('city')
+ipapi.location(None, None, 'city')
 # Gets your city name
 u'Wilton'
 
-ipapi.field('country')
+ipapi.location(None, None, 'country')
 # Gets your country
 u'US'
 
 ipapi.location('8.8.8.8')
 # Gets complete location for IP address 8.8.8.8
 {u'city': u'Mountain View', u'ip': u'8.8.8.8', u'region': u'California', u'longitude': -122.0838, u'country': u'US', u'latitude': 37.386, u'timezone': u'America/Los_Angeles', u'postal': u'94035'}
 
-ipapi.field('city', '8.8.8.8')
+ipapi.location('8.8.8.8', None, 'city')
 # Gets city name for IP address 8.8.8.8
 u'Mountain View'
 
-ipapi.field('country', '8.8.8.8')
+ipapi.location('8.8.8.8', None, 'country')
 # Gets country for IP address 8.8.8.8
 u'US'
 ```
@@ -75,4 +76,9 @@ API key can be specified in the following ways :
 
 1. Inside `ipapi.py` by setting `API_KEY` variable
 2. Via command line with the `-k` option
-3. As a function argument e.g. `ipapi.field(field='country', ip='8.8.8.8', key='xyz')` or `ipapi.location(ip='8.8.8.8', key='xyz')`
+3. As a function argument e.g. `ipapi.location(ip='8.8.8.8', key='secret-key')` or `ipapi.location(ip='8.8.8.8', key='secret-key', field='city')`
+
+### Notes
+- All function arguments (`ip`, `key`, `field`) are optional . To skip an argument, use `None` or an empty string `''`.
+  `ipapi.location(ip='8.8.8.8', key=None, field='city')`
+  `ipapi.location(ip='8.8.8.8', key='',   field='city')`