class_docstr: 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()`.
class_docstr_tok: ["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","(",")","`","."]
docstr: Limit area of interest to resolve an ambiguity.
  
  Parameters
  ----------
  scope : str 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
  --------
  .. jupyter-execute::
      :linenos:
      :emphasize-lines: 6
  
      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')
docstr_tok: ["Limit","area","of","interest","to","resolve","an","ambiguity",".","Parameters","--","--","--","--","--","scope",":","str","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","--","--","--","--","..","jupyter-execute",":",":",":","linenos",":",":","emphasize-lines",":","6","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","'",")"]
code: def scope(self, scope) -> "NamesGeocoder":
      """
      Limit area of interest to resolve an ambiguity.
  
      Parameters
      ----------
      scope : str 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
      --------
      .. jupyter-execute::
          :linenos:
          :emphasize-lines: 6
  
          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')
  
      """
      self._reset_geocodes()
      self._scope = _prepare_new_scope(scope)
      return self
  
imports: from collections import namedtuple
  from collections.abc import Iterable
  from typing import Union, List, Optional, Dict
  from pandas import Series
  from .geocodes import _to_level_kind, request_types, Geocodes, _raise_exception, _ensure_is_list
  from .gis.geocoding_service import GeocodingService
  from .gis.geometry import GeoRect, GeoPoint
  from .gis.request import RequestBuilder, GeocodingRequest, RequestKind, MapRegion, AmbiguityResolver, RegionQuery, LevelKind, IgnoringStrategyKind, PayloadKind, ReverseGeocodingRequest
  from .gis.response import Response, SuccessResponse
  from .type_assertion import assert_list_type
label_desc: Use image node_id 2 for calling the NamesGeocoder obj's underlying member method code with example usage: obj.scope(scope) and returns: self