====== API Geomap ======
home/app/apis/geomap/geomap_api_controller.php\\
//class GeomapApiController extends ApiController//\\
\\
=== _get_css_size ===
Prende un numero o una stringa e la ritorna nel valore in px valido per lo stile css.\\
Descrizione: //_get_css_sizeo($dim)//\\
Parametri: $dim - int o string\\
Return: string

=== add_map ===
Aggiunge una nuova mappa nel database e ritorna il suo id nella tabella GeoMap.\\
Descrizione: //add_map($owner,$owner_id,$boundingBox,$label,$maptype)//\\
Parametri:
    * $owner - string
    * $owner_id - int
    * $boundingBox - mixed, o un GeoPolygon o un array o un paio di valori accettati da <Geopolygon::byBounds>
    * $label - string, opzionale
    * $maptype - string, opzionale tra: NORMAL_MAP, SATELLITE_MAP, HYBRID_MAP, PHYSICAL_MAP, MAPNIK, OSMARENDER
Return: int

=== add_shape ===
Aggiunge una forma (punto, linea, sagoma...) al database, eventualmente associandola ad una mappa.\\
Descrizione: //add_shape($ar_or_shape,$geomap_id,$options)//\\
Parametri:
    * $ar_or_shape
    * $geomap_id - string
    * $oprions - string
Return: void

=== change_default_maptype ===
Cambia il maptype di una mappa.\\
Descrizione: //change_default_maptype($map_id,$maptype)//\\
Parametri:
    * $map_id - int
    * $maptype - string, opzionale tra i vari tipi di mappa
Return: void

=== find_map_by_owner ===
Trova la mappa attraverso il suo propriertario.\\
Descrizione: //find_map_by_owner($owner,$owner_id)//\\
Parametri:
    * $owner - string
    * $owner_id - string
Return: void

=== find_shapes ===
Ritorna un array con elencati gli id delle figure associate alle mappe.\\
Descrizione: //find_shapes($owner_or_map_id,$owner_id,$intersected_with)//\\
Parametri:
    * $owner_or_map_id - string 
    * $owner_id - int
    * $intersected_with - string
Return: array

=== get_maps ===
Trova tutte le mappe associate ad $owner.\\
Descrizione: //get_maps($owner,$owner_id)//\\
Parametri:
    * $owner - string
    * $owner_id - int
Return: array

=== get_maps_info ===
Ritorna le informazioni sulla mappa.\\
Descrizione: //get_maps_info($owner_or_map_id,$owner_id)//\\
Parametri:
    * $owner_or_map - string
    * $owner_id - int
Return: void

=== prepare_map_rendering ===
Crea e ritorna un'istanza di Map Helper riferita alla mappa associata, renderizzando una vista provvisoria.\\
Descrizione: //prepare_map_rendering($map_id,$js_var_suffixe)//\\
Parametri:
    * $map_id - int
    * $js_var_suffixe - string, opzionale, è il suffisso dato alla variabile map di javascript, che identifica la mappa.
Return: array

=== remove_shape ===
Rimuove le figure presenti nel database.\\
Descrizione: //remove_shape($id_or_owner,$owner_id)//\\
Parametri:
    * $id_or_owner - int
    * $owner_id - int
Return: void

=== render_edit_map ===
Renderizza la mappa e i suoi controlli, abilitandone le modifiche.\\
Descrizione: //render_edit_map($data,$options,$js_var_suffix)//\\
Parametri:
    * $data - array
    * $options - array, opzionale
    * $js_var_suffix - string, opzionale, suffisso usato in javascript.
Return: void

=== render_show_map ===
Renderizza una mappa non modificabile.\\
Descrizione: //render_show_map($data,$options,$js_var_suffix)//\\
Parametri: 
    * $data - array
    * $options - array, opzionale
    * $js_var_suffix - string, opzionale, suffisso usato in javascript.
Return: void

=== save_map ===
Aggiunge o aggiorna una mappa e ne ritorna l'id.\\
Descrizione: //save_map($data,$options)//\\
Parametri:
    * $data - array
    * $options - array, opzionale con le opzioni di permessi e rendering
Return: int, ovvero l'id della mappa

=== save_shapes ===
Aggiunge o aggiorna le figure all'interno del db.\\
Descrizione: //save_shapes($data,$options)//\\
Parametri:
    * $data - array
    * $options - array, opzionale con le opzioni di permessi e rendering
Return: void