### Administration - Geoloc

#### System settings

##### Table field for latitude and longitude

Introduce the fields available in the database for storing the latitudes and longitudes of site members.

##### IP geolocation

This option allows you to enable or disable:
- storage in the database of anonymous visitor IPs, their geolocation, the number of visits and their visiting position on the site
- display of this data in the interface
NB: this option can considerably slow down the display of the map (if you are logged in as an administrator and your database contains a lot of lines (> 10,000 IPs)) and store a lot of data in the database over time. You can empty the database at any time.

How it works:
IP georeferencing is provided by different providers and complements the site's database.
We use 4 IP geolocation providers:
https://ipapi.co ==> max 1000 requests per day, 30,000 per month
https://api.ipdata.co => requires API key ==> max 1,500 requests per day
https://extreme-ip-lookup.com ==> max 20 requests per minute, 50,000 per month
http://ip-api.com ==> max 150 requests per minute (ban)
All these providers have a free usage limit or their number to be able to ensure continuous operation remaining free...

##### Ipdata API key

This key is optional it allows you to use data from ipdata.co you can obtain it here:
https://ipdata.co/sign-up.html

#### Card interface

##### Azure Maps API key

This key allows you to use Azure Maps data. If you want to use this data, go to https://learn.microsoft.com/en-us/azure/azure-maps/quick-demo-map-app and follow the process (creating an account then obtaining a key)... and fill in the field.

##### Mapbox API key

This key (optional) allows you to use Mapbox data. If you wish to use this data go to https://www.mapbox.com and follow the process (creating an account then obtaining a key)... and fill in the field.

##### Card type

You can define the default basemap here, depending on the providers available to you and the API keys you have obtained

NB: The Stadia Maps provider requires at least the creation of an account and the designation of your domain name for authentication. You can complete the process here: https://docs.stadiamaps.com/authentication/

- OpenStreetMap
  - Map (OpenStreetMap)
- Mapbox <== API key required
  - Relief (Mapbox)
  - Map (Mapbox)
- Azure Maps <== API key required
  - Map (Azure Maps)
  - Satellite (Azure Maps)
  - Dark (Azure Maps)
- Google maps
  - Satellite (Google maps)
- Stadia Maps <== autorisation requise
  - Plan (Stadia Maps)
  - Draw (Stadia Maps)
  - Plan light (Stadia Maps)
  - Plan dark (Stadia Maps)

##### Coordinate unit

Allows you to define the default display of coordinates

- dms: degrees minutes seconds (ex: 52°28' 58" S | 9°29' 32" E)
- dd: decimal degrees (ex: 63.391522 | 146.953125)

##### Marker type

You can choose between two types of icons which will represent:

- site members not logged in
- connected site members
- anonymous people connected

NB: the icons for IPs cannot be configured.

1. Images in png, gif (animated gif not supported), jpeg format.
These are stored at the address defined in the image path parameters (supra). You can choose the images you want and adjust their final display dimension on the card in the width and height fields.

Default:

2. Webfonts (fontawesome).
You can therefore choose from the proposed list...

-  User
-  User in circle
-  Users
-  Heart
-  Pinchpin
-  Circle
-  Camera
-  Anchor
-  Map marker
-  Airplane
-  Star
-  Home
-  Flag
-  Cross
-  Asterisk
-  Flame
-  Comment

... and adjust the color, the opacity of the background and the lines, and the final display dimension on the map in the width and height fields.

By default :   

#### Block interface

You can define here for the block:

- the base map (see above in Map interface)
- the icon, (address defined in the image path (see above in Parameters)), and its dimensions
- the height of the block
- the zoom factor

Default:

NPDS - Geoloc Manuel administration