Call a view
To call a View directly with the viewid
, the following URL can be used.
https://hostname/v/viewid/
The term hostname
is to be replaced here by the respective hostname of the PlexMap instance.
Initial view Anchor
The viewer can be further parameterized. The valid parameters are described below. These are at least
- either
lat
(latitude),lon
(longitude) andheight
- or
x
(right value in the coordinate system (e.g. Gauss-Krüger or UTM),y
(high value) undz
(hight).
Optionale parameters are:
gr
(elevation referencerelative
for relative hights above the terrain,absolute
for absolute heights or default value:none
)elevation
(distance of the camera from the named point in meters, default value:100
) andyaw
(rotation of the camera in degrees (yaw angle),0
is direction north,90
east etc., default value:0
).pitch
(rotation of the camera in degrees (tilt),-90
is from above,0
is no tilt, default value:-25
).layers
(specification of Layers to be shown/hidden initially, e.g.+orthofoto,-toppluswms
)image
(PlexMap Street 360°/PlexMap Oblique: direct call of the specified image)marker
((Parameter for PlexMap 2D, 3D and PlexMap Oblique: Signalled address call by a marker, instructions see below)
An example of a vistalink with explicit components would be the following URL:
https://demo.geoplex.de/v/campus-demo/?lat=51.07833792&lon=6.90529936&yaw=14&elevation=700
Note: If certain values like elevation
or pitch
are chosen too small, the viewer may jump directly to pedestrian mode (normal behavior). Choose larger values if this is not intended.
Initial viewer mode Anchor
If multiple viewer modes are configured in a View, the desired viewer mode can be passed in the URL. Then the default start mode will be overwritten and the viewer will start in the specified mode:
https://demo.geoplex.de/v/campus-demo/?state=cesium
Possible values (available depending on licensing):
Mode | Value |
3D | cesium |
2D | map |
Oblique viewer | oblique |
Initial search Anchor
Another View URL parameter is the initial search query. This is passed by the abbreviation q
. If the search line is activated in the View, a search is started immediately and jumps to the first entry found. For example, the address search can be called directly:
https://demo.geoplex.de/v/campus-demo/?q=Am%20Hang%202a
Call via Vistacode Anchor
In addition to the above described parameterization of the View, there is another possibility to call the viewer with a specific View. For this purpose, a Vistacode (link) can be generated with the "share link" tool. This code contains all the necessary information about a View, but is only machine readable to keep the link as small as possible. An example is the following:
https://demo.geoplex.de/v/campus-demo/?359hLV64Ms_C73EK8Wa4IM99A5nl6C45k4Nl000000
Viewer layout Anchor
The layout can be customized using the view URL parameter layout
. By default, all controls are displayed in full
layout. The slim
layout has reduced variants of the controls. The minimal
layout presents only the map content without controls:
https://demo.geoplex.de/v/campus-demo/?layout=minimal
Possible values:
Layout | Value |
full | full |
slim | slim |
minimal | minimal |
Show marker as result of an address or coordinate call Anchor
The view URL parameter marker=1
can be used to call a view with a marker as the result of an address or coordinate search. This works in the viewer states 3D, 2D and Oblique.
Coordinate call
If you want to call for a coordinate, first specify the x and y coordinates and then marker=1. Example:
https://hostname/v/viewid/?state=oblique&x=171655.659559305&y=484075.696048545&marker=1
Address call
If you want to call for an address, first specify the address and then &marker=1. Example:
https://hostname/v/viewid/?state=oblique&q=streetname%20housenumber,city&marker=1
Marker styling
Basically, PlexMap's default marker is colored and displayed in the highlight color of your view. If you want to style the marker differently, this is possible in the settings of your view under Tools -> Search bar -> Search marker icon. The search marker icon should be uploaded as SVG if possible.