class_docstr: Yandex geocoder.
  
  Documentation at:
      https://tech.yandex.com/maps/doc/geocoder/desc/concepts/input_params-docpage/
class_docstr_tok: ["Yandex","geocoder",".","Documentation","at",":","https",":","\/\/tech.yandex.com\/maps\/doc\/geocoder\/desc\/concepts\/input_params-docpage\/"]
docstr: Return an address by location point.
  
  :param query: The coordinates for which you wish to obtain the
      closest human-readable addresses.
  :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude,
      longitude)``, or string as ``"%(latitude)s, %(longitude)s"``.
  
  :param bool exactly_one: Return one result or a list of results, if
      available.
  
  :param int timeout: Time, in seconds, to wait for the geocoding service
      to respond before raising a :class:`geopy.exc.GeocoderTimedOut`
      exception. Set this only if you wish to override, on this call
      only, the value set during the geocoder's initialization.
  
  :param str kind: Type of toponym. Allowed values: `house`, `street`, `metro`,
      `district`, `locality`.
  
  :param str lang: Language of the response and regional settings
      of the map. List of supported values:
  
      - ``tr_TR`` -- Turkish (only for maps of Turkey);
      - ``en_RU`` -- response in English, Russian map features;
      - ``en_US`` -- response in English, American map features;
      - ``ru_RU`` -- Russian (default);
      - ``uk_UA`` -- Ukrainian;
      - ``be_BY`` -- Belarusian.
  
  :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if
      ``exactly_one=False``.
docstr_tok: ["Return","an","address","by","location","point",".",":","param","query",":","The","coordinates","for","which","you","wish","to","obtain","the","closest","human-readable","addresses",".",":","type","query",":",":","class",":","`","geopy.point.Point","`",",","list","or","tuple","of","``","(","latitude",",","longitude",")","``",",","or","string","as","``","``","%","(","latitude",")","s",",","%","(","longitude",")","s","''","``",".",":","param","bool","exactly_one",":","Return","one","result","or","a","list","of","results",",","if","available",".",":","param","int","timeout",":","Time",",","in","seconds",",","to","wait","for","the","geocoding","service","to","respond","before","raising","a",":","class",":","`","geopy.exc.GeocoderTimedOut","`","exception",".","Set","this","only","if","you","wish","to","override",",","on","this","call","only",",","the","value","set","during","the","geocoder","'s","initialization",".",":","param","str","kind",":","Type","of","toponym",".","Allowed","values",":","`","house","`",",","`","street","`",",","`","metro","`",",","`","district","`",",","`","locality","`",".",":","param","str","lang",":","Language","of","the","response","and","regional","settings","of","the","map",".","List","of","supported","values",":","-","``","tr_TR","``","--","Turkish","(","only","for","maps","of","Turkey",")",";","-","``","en_RU","``","--","response","in","English",",","Russian","map","features",";","-","``","en_US","``","--","response","in","English",",","American","map","features",";","-","``","ru_RU","``","--","Russian","(","default",")",";","-","``","uk_UA","``","--","Ukrainian",";","-","``","be_BY","``","--","Belarusian",".",":","rtype",":","``","None","``",",",":","class",":","`","geopy.location.Location","`","or","a","list","of","them",",","if","``","exactly_one=False","``","."]
code: def reverse(
      self,
      query,
      *,
      exactly_one=True,
      timeout=DEFAULT_SENTINEL,
      kind=None,
      lang=None,
  ):
      """
      Return an address by location point.
  
      :param query: The coordinates for which you wish to obtain the
          closest human-readable addresses.
      :type query: :class:`geopy.point.Point`, list or tuple of ``(latitude,
          longitude)``, or string as ``"%(latitude)s, %(longitude)s"``.
  
      :param bool exactly_one: Return one result or a list of results, if
          available.
  
      :param int timeout: Time, in seconds, to wait for the geocoding service
          to respond before raising a :class:`geopy.exc.GeocoderTimedOut`
          exception. Set this only if you wish to override, on this call
          only, the value set during the geocoder's initialization.
  
      :param str kind: Type of toponym. Allowed values: `house`, `street`, `metro`,
          `district`, `locality`.
  
      :param str lang: Language of the response and regional settings
          of the map. List of supported values:
  
          - ``tr_TR`` -- Turkish (only for maps of Turkey);
          - ``en_RU`` -- response in English, Russian map features;
          - ``en_US`` -- response in English, American map features;
          - ``ru_RU`` -- Russian (default);
          - ``uk_UA`` -- Ukrainian;
          - ``be_BY`` -- Belarusian.
  
      :rtype: ``None``, :class:`geopy.location.Location` or a list of them, if
          ``exactly_one=False``.
      """
  
      try:
          point = self._coerce_point_to_string(query, "%(lon)s,%(lat)s")
      except ValueError:
          raise ValueError("Must be a coordinate pair or Point")
      params = {"geocode": point, "format": "json"}
      params["apikey"] = self.api_key
      if lang:
          params["lang"] = lang
      if kind:
          params["kind"] = kind
      url = "?".join((self.api, urlencode(params)))
      logger.debug("%s.reverse: %s", self.__class__.__name__, url)
      callback = partial(self._parse_json, exactly_one=exactly_one)
      return self._call_geocoder(url, callback, timeout=timeout)
  
file_path: geopy/geopy/geocoders/yandex.py
imports: from functools import partial
  from urllib.parse import urlencode
  from geopy.exc import GeocoderParseError, GeocoderServiceError
  from geopy.geocoders.base import DEFAULT_SENTINEL, Geocoder
  from geopy.location import Location
  from geopy.util import logger
label_desc: Use image node_id 3 for calling the Yandex obj's underlying member method code with example usage: obj.reverse(query) and returns: self