docstr: Construct a new Symbol object
  
  Parameters
  ----------
  arg
      dict of properties compatible with this constructor or
      an instance of
      :class:`plotly.graph_objs.layout.mapbox.layer.Symbol`
  icon
      Sets the symbol icon image (mapbox.layer.layout.icon-
      image). Full list: https://www.mapbox.com/maki-icons/
  iconsize
      Sets the symbol icon size (mapbox.layer.layout.icon-
      size). Has an effect only when `type` is set to
      "symbol".
  placement
      Sets the symbol and/or text placement
      (mapbox.layer.layout.symbol-placement). If `placement`
      is "point", the label is placed where the geometry is
      located If `placement` is "line", the label is placed
      along the line of the geometry If `placement` is "line-
      center", the label is placed on the center of the
      geometry
  text
      Sets the symbol text (mapbox.layer.layout.text-field).
  textfont
      Sets the icon text font (color=mapbox.layer.paint.text-
      color, size=mapbox.layer.layout.text-size). Has an
      effect only when `type` is set to "symbol".
  textposition
      Sets the positions of the `text` elements with respects
      to the (x,y) coordinates.
  
  Returns
  -------
  Symbol
docstr_tok: ["Construct","a","new","Symbol","object","Parameters","--","--","--","--","--","arg","dict","of","properties","compatible","with","this","constructor","or","an","instance","of",":","class",":","`","plotly.graph_objs.layout.mapbox.layer.Symbol","`","icon","Sets","the","symbol","icon","image","(","mapbox.layer.layout.icon-","image",")",".","Full","list",":","https",":","\/\/www.mapbox.com\/maki-icons\/","iconsize","Sets","the","symbol","icon","size","(","mapbox.layer.layout.icon-","size",")",".","Has","an","effect","only","when","`","type","`","is","set","to","``","symbol","''",".","placement","Sets","the","symbol","and\/or","text","placement","(","mapbox.layer.layout.symbol-placement",")",".","If","`","placement","`","is","``","point","''",",","the","label","is","placed","where","the","geometry","is","located","If","`","placement","`","is","``","line","''",",","the","label","is","placed","along","the","line","of","the","geometry","If","`","placement","`","is","``","line-","center","''",",","the","label","is","placed","on","the","center","of","the","geometry","text","Sets","the","symbol","text","(","mapbox.layer.layout.text-field",")",".","textfont","Sets","the","icon","text","font","(","color=mapbox.layer.paint.text-","color",",","size=mapbox.layer.layout.text-size",")",".","Has","an","effect","only","when","`","type","`","is","set","to","``","symbol","''",".","textposition","Sets","the","positions","of","the","`","text","`","elements","with","respects","to","the","(","x",",","y",")","coordinates",".","Returns","--","--","--","-","Symbol"]
code: def __init__(
      self,
      arg=None,
      icon=None,
      iconsize=None,
      placement=None,
      text=None,
      textfont=None,
      textposition=None,
      **kwargs,
  ):
      """
      Construct a new Symbol object
  
      Parameters
      ----------
      arg
          dict of properties compatible with this constructor or
          an instance of
          :class:`plotly.graph_objs.layout.mapbox.layer.Symbol`
      icon
          Sets the symbol icon image (mapbox.layer.layout.icon-
          image). Full list: https://www.mapbox.com/maki-icons/
      iconsize
          Sets the symbol icon size (mapbox.layer.layout.icon-
          size). Has an effect only when `type` is set to
          "symbol".
      placement
          Sets the symbol and/or text placement
          (mapbox.layer.layout.symbol-placement). If `placement`
          is "point", the label is placed where the geometry is
          located If `placement` is "line", the label is placed
          along the line of the geometry If `placement` is "line-
          center", the label is placed on the center of the
          geometry
      text
          Sets the symbol text (mapbox.layer.layout.text-field).
      textfont
          Sets the icon text font (color=mapbox.layer.paint.text-
          color, size=mapbox.layer.layout.text-size). Has an
          effect only when `type` is set to "symbol".
      textposition
          Sets the positions of the `text` elements with respects
          to the (x,y) coordinates.
  
      Returns
      -------
      Symbol
      """
      super(Symbol, self).__init__("symbol")
  
      if "_parent" in kwargs:
          self._parent = kwargs["_parent"]
          return
  
      # Validate arg
      # ------------
      if arg is None:
          arg = {}
      elif isinstance(arg, self.__class__):
          arg = arg.to_plotly_json()
      elif isinstance(arg, dict):
          arg = _copy.copy(arg)
      else:
          raise ValueError(
              """\
  The first argument to the plotly.graph_objs.layout.mapbox.layer.Symbol
  constructor must be a dict or
  an instance of :class:`plotly.graph_objs.layout.mapbox.layer.Symbol`"""
          )
  
      # Handle skip_invalid
      # -------------------
      self._skip_invalid = kwargs.pop("skip_invalid", False)
      self._validate = kwargs.pop("_validate", True)
  
      # Populate data dict with properties
      # ----------------------------------
      _v = arg.pop("icon", None)
      _v = icon if icon is not None else _v
      if _v is not None:
          self["icon"] = _v
      _v = arg.pop("iconsize", None)
      _v = iconsize if iconsize is not None else _v
      if _v is not None:
          self["iconsize"] = _v
      _v = arg.pop("placement", None)
      _v = placement if placement is not None else _v
      if _v is not None:
          self["placement"] = _v
      _v = arg.pop("text", None)
      _v = text if text is not None else _v
      if _v is not None:
          self["text"] = _v
      _v = arg.pop("textfont", None)
      _v = textfont if textfont is not None else _v
      if _v is not None:
          self["textfont"] = _v
      _v = arg.pop("textposition", None)
      _v = textposition if textposition is not None else _v
      if _v is not None:
          self["textposition"] = _v
  
      # Process unknown kwargs
      # ----------------------
      self._process_kwargs(**dict(arg, **kwargs))
  
      # Reset skip_invalid
      # ------------------
      self._skip_invalid = False
  
file_path: plotly.py/packages/python/plotly/plotly/graph_objs/layout/mapbox/layer/_symbol.py
imports: from plotly.basedatatypes import BaseLayoutHierarchyType
  import copy
label_desc: Use image node_id 14 to create a new Symbol object from inherited base classes: _BaseLayoutHierarchyType with example: obj = Symbol(arg, icon, iconsize, placement, text, textfont, textposition)