lets_plot.geo_data.NamesGeocoder

class lets_plot.geo_data.NamesGeocoder(level: Optional[Union[str, lets_plot.geo_data.gis.request.LevelKind]] = None, request: Optional[Union[str, List[str], pandas.core.series.Series]] = None)

Do not use this class explicitly.

Instead you should construct its objects with special functions: geocode(), geocode_cities(), geocode_counties(), geocode_states(), geocode_countries(), reverse_geocode().

__init__(level: Optional[Union[str, lets_plot.geo_data.gis.request.LevelKind]] = None, request: Optional[Union[str, List[str], pandas.core.series.Series]] = None)

Initialize self.

scope(scope) → lets_plot.geo_data.geocoder.NamesGeocoder

Limit area of interest to resolve an ambiguity.

Parameters

scopestr or Geocoder

Area of interest. If it is of str type then it should be the geo-object name. If it is of Geocoder type then it must contain only one object.

Returns

NamesGeocoder

Geocoder object specification.

Examples

from IPython.display import display
from lets_plot import *
from lets_plot.geo_data import *
LetsPlot.setup_html()
scope = geocode_states('Kentucky')
city = geocode_cities('Franklin').scope(scope).get_boundaries()
display(city)
ggplot() + geom_map(data=city) + ggtitle('Franklin, Kentucky')

The geodata is provided by © OpenStreetMap contributors and is made available here under the Open Database License (ODbL).