lets_plot.geo_data.geocode#

lets_plot.geo_data.geocode(level=None, names=None, countries=None, states=None, counties=None, scope=None) NamesGeocoder#

Create a NamesGeocoder. Allow to refine ambiguous request with where() method, scope that limits area of geocoding or with parents.

Parameters:
level{‘country’, ‘state’, ‘county’, ‘city’}

The level of administrative division. Autodetection by default.

nameslist or str

Names of objects to be geocoded. For ‘state’ level: ‘US-48’ returns continental part of United States (48 states) in a compact form.

countrieslist

Parent countries. Should have same size as names. Can contain strings or Geocoder objects.

stateslist

Parent states. Should have same size as names. Can contain strings or Geocoder objects.

countieslist

Parent counties. Should have same size as names. Can contain strings or Geocoder objects.

scopestr or Geocoder

Limits area of geocoding. If parent country is set then error will be generated. If type is a string - geoobject should have geocoded scope in parents. If type is a Geocoder - geoobject should have geocoded scope in parents. Scope should contain only one entry.

Returns:
NamesGeocoder

Geocoder object specification.

Examples

1from IPython.display import display
2from lets_plot import *
3from lets_plot.geo_data import *
4LetsPlot.setup_html()
5states = geocode('state').scope('Italy').get_boundaries(6)
6display(states.head())
7ggplot() + geom_map(data=states)
The geodata is provided by © OpenStreetMap contributors and is made available here under the Open Database License (ODbL).
state found name geometry
0 Sicily Sicily MULTIPOLYGON (((11.93996 36.83784, 12.01368 36...
1 Molise Molise MULTIPOLYGON (((13.94101 41.68797, 14.01883 41...
2 Tuscany Tuscany MULTIPOLYGON (((9.81009 43.00208, 9.79309 43.0...
3 Umbria Umbria MULTIPOLYGON (((11.95935 42.86868, 11.93497 42...
4 Emilia-Romagna Emilia-Romagna MULTIPOLYGON (((9.20032 44.68640, 9.24248 44.6...

 1from IPython.display import display
 2from lets_plot import *
 3from lets_plot.geo_data import *
 4LetsPlot.setup_html()
 5states = geocode(level='state', scope='US').get_geocodes()
 6display(states.head())
 7names = ['York'] * len(states.state)
 8cities = geocode(names=names, states=states.state).ignore_not_found().get_centroids()
 9display(cities.head())
10ggplot() + \
11    geom_livemap() + \
12    geom_point(data=cities, tooltips=layer_tooltips().line('@{found name}'))
id state found name centroid position limit
0 60759 Vermont Vermont [-72.772353529363, 43.8718488067389] [-73.4377402067184, 42.7269606292248, -71.4653... [-73.4377402067184, 42.7269606292248, -71.4653...
1 61315 Massachusetts Massachusetts [-72.0964509339039, 42.1913791447878] [-73.5082098841667, 41.4945808053017, -69.9292... [-73.5082098841667, 41.2393619120121, -69.9292...
2 61320 New York New York [-76.0912327538441, 42.8993669897318] [-79.7619438171387, 40.7823456823826, -73.2414... [-79.7619438171387, 40.4960802197456, -71.8561...
3 63512 Maine Maine [-69.1608471741827, 45.2623642981052] [-71.0841688513756, 43.0649779736996, -66.9498... [-71.0841688513756, 42.9808665812016, -66.9498...
4 67213 New Hampshire New Hampshire [-71.5517876605831, 44.0015134960413] [-72.5572353601456, 42.6972283422947, -70.7018... [-72.5572353601456, 42.6972283422947, -70.7018...
city found name state geometry
0 York New York New York POINT (-73.86737 40.68470)
1 York York Maine POINT (-70.67917 43.17851)
2 York Little York Illinois POINT (-90.74261 41.01002)
3 York York Nebraska POINT (-97.59012 40.86006)
4 York York North Dakota POINT (-99.57356 48.31308)