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: Add matched string to geocodes `DataFrame`. Doesn't affect `GeoDataFrame`.
  
  Parameters
  ----------
  v : bool
      If True geocodes `DataFrame` will contain column 'highlights'
      with string that matched the name.
  
  Returns
  -------
  `NamesGeocoder`
      Geocoder object specification.
  
  Examples
  --------
  .. jupyter-execute::
      :linenos:
      :emphasize-lines: 2
  
      from lets_plot.geo_data import *
      geocode(names='OH').allow_ambiguous().highlights(True).get_geocodes()
docstr_tok: ["Add","matched","string","to","geocodes","`","DataFrame","`",".","Does","n't","affect","`","GeoDataFrame","`",".","Parameters","--","--","--","--","--","v",":","bool","If","True","geocodes","`","DataFrame","`","will","contain","column","'highlights'","with","string","that","matched","the","name",".","Returns","--","--","--","-","`","NamesGeocoder","`","Geocoder","object","specification",".","Examples","--","--","--","--","..","jupyter-execute",":",":",":","linenos",":",":","emphasize-lines",":","2","from","lets_plot.geo_data","import","*","geocode","(","names='OH","'",")",".allow_ambiguous","(",")",".highlights","(","True",")",".get_geocodes","(",")"]
code: def highlights(self, v: bool):
      """
      Add matched string to geocodes `DataFrame`. Doesn't affect `GeoDataFrame`.
  
      Parameters
      ----------
      v : bool
          If True geocodes `DataFrame` will contain column 'highlights'
          with string that matched the name.
  
      Returns
      -------
      `NamesGeocoder`
          Geocoder object specification.
  
      Examples
      --------
      .. jupyter-execute::
          :linenos:
          :emphasize-lines: 2
  
          from lets_plot.geo_data import *
          geocode(names='OH').allow_ambiguous().highlights(True).get_geocodes()
  
      """
      self._highlights = v
      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 3 for calling the NamesGeocoder obj's underlying member method code with example usage: obj.highlights(v) and returns: self