leaflet/src/layer.mli

(* BSD-2-Clause License *)

type _ t =
  | Basic : Jv.t -> [> `Basic ] t
  | Geojson : Jv.t -> [> `Geojson ] t
  | Marker : Jv.t -> [> `Marker ] t
  | Tile : Jv.t -> [> `Tile ] t

type _ sub =
  | Basic : [> `Basic ] sub
  | Geojson : [> `Geojson ] sub
  | Marker : [> `Marker ] sub
  | Tile : [> `Tile ] sub

(** Basic layers *)

(** [add_to map layer] adds [layer] to [map] *)
val add_to : Map.t -> _ t -> unit

(** [remove layer] removes [layer] from the map it is currently active on *)
val remove : _ t -> unit

(** [remove_from map layer] removes [layer] from [map] *)
val remove_from : Map.t -> _ t -> unit

(** [bind_popup popup layer] binds [popup] to [layer] *)
val bind_popup : Brr.El.t -> ?options:Jv.t -> _ t -> unit

(** [unbind_popup layer] unbinds the popup bound to [layer] *)
val unbind_popup : _ t -> unit

(** [open_popup layer] opens the popup bound to [layer] *)
val open_popup : _ t -> unit

(** [close_popup layer] closes the popup bound to [layer] *)
val close_popup : _ t -> unit

(** [get_popup layer] is the popup bound to [layer] *)
val get_popup : _ t -> Popup.t

(** [to_jv o] is [o] as a {!Jv.t} *)
val to_jv : _ t -> Jv.t

(** [of_jv tag o] is [o] as a [tag t] *)
val of_jv : 'a sub -> Jv.t -> 'a t

(** [on event handler layer] add an event listener on [layer] for event [event]
    with handler [handler] *)
val on : 'a Event.sub -> ('a Event.t -> 'b) -> 'c t -> unit

(** Geojson layers *)

(** [create_geojson geojson] is a new geojson layer *)
val create_geojson : ?options:Jv.t -> Jv.t -> [ `Geojson ] t

(** Marker layers *)

(** [create_marker latlng] is a new marker with the same position as latlng *)
val create_marker : Latlng.t -> [ `Marker ] t

(** Tile layers *)

(** [create_tile_osm Some(url)] is a new tile layer with tile server specified
    by [url]. Tile server default to [openstreetmap.org]. See
    {:https://wiki.openstreetmap.org/wiki/Tile_servers} *)
val create_tile_osm : string option -> [ `Tile ] t