update to new map types

Author: LiamConnors

doc/python/lines-on-mapbox.md

@@ -5,10 +5,10 @@ jupyter:
     text_representation:
       extension: .md
       format_name: markdown
-      format_version: '1.2'
-      jupytext_version: 1.4.2
+      format_version: '1.3'
+      jupytext_version: 1.16.3
   kernelspec:
-    display_name: Python 3
+    display_name: Python 3 (ipykernel)
     language: python
     name: python3
   language_info:
@@ -20,26 +20,23 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.7.7
+    version: 3.10.0
   plotly:
-    description: How to draw a line on Map in Python with Plotly.
+    description: How to draw a line on tile-based maps in Python with Plotly.
     display_as: maps
     language: python
     layout: base
-    name: Lines on Mapbox
+    name: Lines on Maps
     order: 2
     page_type: example_index
-    permalink: python/lines-on-mapbox/
+    permalink: python/lines-on-tile-maps/
+    redirect_from: python/lines-on-mapbox/
     thumbnail: thumbnail/line_mapbox.jpg
 ---
 
-### Mapbox Access Token and Base Map Configuration
+### Lines on maps using Plotly Express
 
-To plot on Mapbox maps with Plotly you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.
-
-To draw a line on your map, you either can use [`px.line_mapbox()`](https://plotly.com/python-api-reference/generated/plotly.express.line_mapbox.html) in Plotly Express, or [`Scattermapbox`](https://plotly.com/python/reference/scattermapbox/) traces. Below we show you how to draw a line on Mapbox using Plotly Express.
-
-### Lines on Mapbox maps using Plotly Express
+To draw a line on a map, you either can use `px.line_map()` in Plotly Express, or `Scattermap` traces. Here's an example of drawing a line on a tile-based map using Plotly Express.
 
 ```python
 import pandas as pd
@@ -49,17 +46,17 @@ us_cities = us_cities.query("State in ['New York', 'Ohio']")
 
 import plotly.express as px
 
-fig = px.line_mapbox(us_cities, lat="lat", lon="lon", color="State", zoom=3, height=300)
+fig = px.line_map(us_cities, lat="lat", lon="lon", color="State", zoom=3, height=300)
 
-fig.update_layout(mapbox_style="open-street-map", mapbox_zoom=4, mapbox_center_lat = 41,
+fig.update_layout(map_style="open-street-map", map_zoom=4, map_center_lat = 41,
     margin={"r":0,"t":0,"l":0,"b":0})
 
 fig.show()
 ```
 
-### Lines on Mapbox maps from GeoPandas
+### Lines on maps from GeoPandas
 
-Given a GeoPandas geo-data frame with `linestring` or `multilinestring` features, one can extra point data and use `px.line_mapbox()`.
+Given a GeoPandas geo-data frame with `linestring` or `multilinestring` features, one can extra point data and use `px.line_map()`.
 
 ```python
 import plotly.express as px
@@ -94,15 +91,51 @@ for feature, name in zip(geo_df.geometry, geo_df.name):
         lons = np.append(lons, None)
         names = np.append(names, None)
 
-fig = px.line_mapbox(lat=lats, lon=lons, hover_name=names,
-                     mapbox_style="open-street-map", zoom=1)
+fig = px.line_map(lat=lats, lon=lons, hover_name=names,
+                     map="open-street-map", zoom=1)
 fig.show()
 ```
 
-### Lines on Mapbox maps using `Scattermapbox` traces
+### Lines on maps using `Scattermap` traces
 
-This example uses `go.Scattermapbox` and sets
-the [mode](https://plotly.com/python/reference/scattermapbox/#scattermapbox-mode) attribute to a combination of markers and line.
+This example uses `go.Scattermap` and sets
+the [mode](https://plotly.com/python/reference/scattermapbox/#scattermap-mode) attribute to a combination of markers and line.
+
+```python
+import plotly.graph_objects as go
+
+fig = go.Figure(go.Scattermap(
+    mode = "markers+lines",
+    lon = [10, 20, 30],
+    lat = [10, 20,30],
+    marker = {'size': 10}))
+
+fig.add_trace(go.Scattermap(
+    mode = "markers+lines",
+    lon = [-50, -60,40],
+    lat = [30, 10, -20],
+    marker = {'size': 10}))
+
+fig.update_layout(
+    margin ={'l':0,'t':0,'b':0,'r':0},
+    map = {
+        'center': {'lon': 10, 'lat': 10},
+        'style': "open-street-map",
+        'center': {'lon': -20, 'lat': -20},
+        'zoom': 1})
+
+fig.show()
+```
+
+### Mapbox Maps
+
+The earlier examples using `px.line_map` and `go.Scattermap` use Maplibre for rendering. These traces were introduced in Plotly.py 5.24. These trace types are now the recommended way to draw lines on tile-based maps. There are also traces that use Mapbox: `px.line_mapbox` and `go.Scattermapbox`
+
+To plot on Mapbox maps with Plotly you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.
+
+To draw a line on your map, you either can use [`px.line_mapbox()`](https://plotly.com/python-api-reference/generated/plotly.express.line_mapbox.html) in Plotly Express, or [`Scattermapbox`](https://plotly.com/python/reference/scattermapbox/) traces. Below we show you how to draw a line on Mapbox using Plotly Express.
+
+Here's an example of using `Scattermapbox`.
 
 ```python
 import plotly.graph_objects as go
@@ -132,5 +165,8 @@ fig.show()
 
 #### Reference
 
-See [function reference for `px.(line_mapbox)`](https://plotly.com/python-api-reference/generated/plotly.express.line_mapbox) or
-https://plotly.com/python/reference/scattermapbox/ for more information about mapbox and their attribute options.
+See [function reference for `px.(line_map)`](https://plotly.com/python-api-reference/generated/plotly.express.line_map) or
+https://plotly.com/python/reference/scattermap/ for more information about the attributes available.
+
+See Mapbox-based tile maps, see [function reference for `px.(line_mapbox)`](https://plotly.com/python-api-reference/generated/plotly.express.line_mapbox) or
+https://plotly.com/python/reference/scattermapbox/.