arcgis data appliance: openstreetmap vector basemaps...openstreetmap (osm) vector basemaps includes...

ArcGIS Data Appliance:OpenStreetMap Vector

Basemaps

Copyright © 1995-2019 Esri. All rights reserved.

Table of ContentsGet started

What are ArcGIS Data Appliance: OpenStreetMap Vector Basemaps? . . . . . . . . . . . . . . . . . . . . . 4

What do I get with OpenStreetMap Vector Basemaps? . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Directory of map styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Frequently asked questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

System requirements

OSM Vector Basemaps system requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Setup

Setup ArcGIS Data Appliance: OpenStreetMap Vector Basemaps . . . . . . . . . . . . . . . . . . . . . . 14

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Other resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Use

Use OSM Vector Basemaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Customize styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Terms of use

Terms of use for ArcGIS Data Appliance: OpenStreetMap Vector Basemaps . . . . . . . . . . . . . . . . . 38

Copyright information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Support

Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

ArcGIS Data Appliance: OpenStreetMap Vector Basemaps

Copyright © 1995-2019 Esri. All rights reserved. 2

Get started



What are ArcGIS Data Appliance: OpenStreetMap VectorBasemaps?Welcome to the help for ArcGIS Data Appliance: OpenStreetMap Vector Basemaps; hereafter, the product will be referred toas OSM Vector Basemaps. OSM Vector Basemaps provide rich, detailed maps, sourced by contributors with local knowledge,to enhance your ArcGIS and web applications. Vector tiles enable dynamic cartography and provide the flexibility to createyour own basemap style. The vector basemaps are available as tile layers, which can be added to existing maps either as abasemap or overlay layer.

OSM Vector Basemaps provides a content solution that is designed to run with a Standard or Advanced edition of ArcGISEnterprise. It is included with ArcGIS Data Appliance 7.1 with World Standard, World Advanced, North America Standard, andNorth America Advanced product options. It can also be licensed as a stand-alone option.

Note: This feature is not included with the World Basic product option.

OSM Vector Basemaps help includes the following topics:• What's included

• Directory of map styles

• System requirements

• Setup OSM Vector Basemaps

• Information on how to use OSM Vector Basemaps

• Methods to customize OSM Vector Basemap styles

• Reference Information including FAQs, Troubleshooting, and Support



What do I get with OpenStreetMap Vector Basemaps?OpenStreetMap (OSM) Vector Basemaps is delivered on a USB flash drive loaded with two vector tile packages, styles, and astyle publishing toolbox (.tbx). This version includes:• Installation vector tile packages that you upload to your ArcGIS Enterprise portal using ArcGIS Pro and publish as a hosted

vector tile service on your hosting server:▪ OSM_Vector_Basemap_DA71_Install.vtpk—A vector tile package for customers who want to use Web Mercator

Auxiliary Sphere (WMA).

▪ OSM_Vector_Basemap_GCS_DA71_Install.vtpk—A vector tile package for customers who want to use OSM VectorBasemaps in WGS84 Geographic (GCS). This .vtpk uses the WGS84 Geographic, Version 2 tiling scheme.

• Map styles (for each projection) that you publish as vector tile layers to your ArcGIS Enterprise portal to use in your mapsand apps or customize. These styles require resources included in the VectorBasemapStyles folder for publishing. Userscan publish any or all of the full set of five styles. The five map styles are as follows:▪ OpenStreetMap

▪ OpenStreetMap (with Relief)

▪ OpenStreetMap (Esri Street style)

▪ OpenStreetMap (Esri Street with Relief style)

▪ OpenStreetMap (Esri Hybrid Reference style)

The same map styles are available to publish against each OSM Vector Tile Package.

• A Vector Style publishing tool for managing your Vector Basemap tile layers (map styles) on your Enterprise portal:▪ VectorStylePublisher.tbx—This toolbox is used to create new Vector Basemap tile layers.

Note: The OSM_Vector_Basemap_DA71_Install andOSM_Vector_Basemap_GCS_DA71_Install vector tile packages are not meant for anyother use than publishing the Tile Layer (hosted). Once published to your Portal, the.vtpk items should not be set as shared to Everyone, as distribution of these itemsoutside of your organization is not permitted.



Directory of map stylesOpenStreetMap (OSM) Vector Basemaps includes the following five vector tile layers. The styles are available to be publishedin Web Mercator Auxiliary Sphere (WMA) projection or WGS84/GCS tiling scheme (GCS).

Layer name andthumbnail

Style folder name Description

OpenStreetMap openstreetmap This tile layer presents avector basemap ofOpenStreetMap (OSM)data created by Esri. Esriproduced this vector tilebasemap in ArcGIS Profrom a live replica ofOSM data that wasrendered using OSMcartography.

OpenStreetMap (withRelief)

openstreetrelief This tile layer presents avector basemap ofOpenStreetMap (OSM)data created by Esri. Esriproduced this vector tilebasemap in ArcGIS Profrom a live replica ofOSM data that wasrendered using OSMcartography with theadded benefit of beingdesigned to use anunderlying WorldHillshade layer.

OpenStreetMap (EsriStreet style)

openstreetmapesristreetstyle This tile layer presents avector basemap ofOpenStreetMap (OSM)data created by Esri. Esriproduced this vector tilebasemap in ArcGIS Profrom a live replica ofOSM data that wasrendered using acartographic style similarto the Esri VectorBasemap World StreetMap style.



OpenStreetMap (EsriStreet with Relief style)

openstreetmapesristreetreliefstyle This tile layer presents avector basemap ofOpenStreetMap (OSM)data created by Esri. Esriproduced this vector tilebasemap in ArcGIS Profrom a live replica ofOSM data that wasrendered using acartographic style similarto the Esri VectorBasemap World StreetMap (with Relief) style. Itis designed to be usedwith World Hillshade.

OpenStreetMap (EsriHybrid Reference style)

openstreetmapesrihybridstyle This tile layer presents avector basemap ofOpenStreetMap (OSM)data created by Esri. Esriproduced this vector tilebasemap in ArcGIS Profrom a live replica ofOSM data that wasrendered using acartographic style similarto the Esri VectorBasemap HybridReference Layer style.This layer is designed tobe overlaid on imagery.



Frequently asked questionsListed below are frequently asked questions and answers regarding ArcGIS Data Appliance: OpenStreetMap VectorBasemaps.

• How does ArcGIS Data Appliance: OpenStreetMap Vector Basemaps work?

• How do I set up OSM Vector Basemaps?

• Where does the data come from?

• Do the OSM Vector Basemaps include imagery?

• What services are available?

• Are there any use restrictions when using OSM Vector Basemaps?

• Where can I find more information about editing custom styles?

• Where can I find more information about using basemaps in my Portal for ArcGIS Map Viewer?

• What if I need further assistance?

How does ArcGIS Data Appliance: OpenStreetMap Vector Basemaps work?

ArcGIS Data Appliance: OpenStreetMap Vector Basemaps (hereafter referred to as OSM Vector Basemaps) is published as ahosted vector tile service from your Enterprise portal along with five map styles that you can share, use, and customize withinyour organization. For more information on vector basemaps and the differences between raster and vector tile layers, see Tilelayers in the Portal for ArcGIS help.

How do I set up OSM Vector Basemaps?

See Other resources for instructional videos and help documentation on the OSM Vector Basemaps section of the ArcGISData Appliance 7.1 website to learn how to deploy and use OSM Vector Basemaps.

Where does the data come from?

The data is provided exclusively by OpenStreetMap (OSM) and its contributors. Esri maintains a replica of the OSM database,which Esri used to author the map using OSM cartography and generate a vector tile package.

Do the OSM Vector Basemaps include imagery?

No. The OSM Vector Basemaps do not include raster basemaps or imagery.

What services are available?

OSM Vector Basemaps only requires one service published as a hosted vector tile layer from your portal. Other maps areincluded as map styles that you publish to your portal as tile layers. See Directory of map styles for the vector tile layersincluded with OSM Vector Basemaps.



https://enterprise.arcgis.com/en/portal/latest/use/tile-layers.htmhttps://enterprise.arcgis.com/en/portal/latest/use/tile-layers.htm

Are there any use restrictions when using OSM Vector Basemaps?

The OSM Vector Basemaps provided via ArcGIS Data Appliance are intended for use with Esri software. Redistribution rightsare granted by Esri and the data vendor for hard-copy renditions or static, electronic map images (for example, .gif and .jpeg)that are plotted, printed, or publicly displayed with proper metadata and source or copyright attribution to the respective datavendor or vendors. For copyright and attribution information, see the Credits for a specific map published on your portal.

Where can I find more information about editing custom styles?

View the Working with and Customizing Esri Vector Basemaps: The Basics post on the ArcGIS Blog website for moreinformation about editing custom styles.

Where can I find more information about using basemaps in my Portal for ArcGIS Map Viewer?

See Customize basemaps and Choose basemap in the Portal for ArcGIS help for more information about using basemaps inyour Portal for ArcGIS Map Viewer.

What if I need further assistance?

For all questions, feedback, troubleshooting, and to report issues, contact Esri Support.



https://www.esri.com/arcgis-blog/products/arcgis-living-atlas/mapping/working-with-and-customizing-esri-vector-basemaps-the-basics/https://enterprise.arcgis.com/en/portal/latest/administer/windows/customize-basemaps.htmhttps://enterprise.arcgis.com/en/portal/latest/use/choose-basemap.htmhttps://support.esri.com/contact-tech-support

System requirements



OSM Vector Basemaps system requirementsThe following software components and prerequisites are required before you deploy OpenStreetMap (OSM) VectorBasemaps:• ArcGIS Pro Basic, Standard, or Advanced 2.4.3 or later

• An ArcGIS Enterprise 10.7.1 or 10.8 deployment minimally meeting the base ArcGIS Enterprise deployment specifications.

Note: Authentication exclusions—The Linux Public-key infrastructure (PKI) configuration isnot supported.

Before you start1. Check with your portal administrator to verify or request the following:

• You need an account on your Portal for ArcGIS with the Publisher or Administrative Roles enabled for your account.

• You need a named user license enabled for ArcGIS Pro Standard or Advanced.

• You must have 64 GB of available space per .vtpk for your portal content directory, 32 GB of available space for yourhosting server’s jobs directory, and 32 GB of available space for your hosting server’s cache directory.

2. Check with your ArcGIS Server administrator to verify or request the following:• You need 64 GB of available disk space per .vtpk on your ArcGIS Server.• Extend the Pooling time for your ArcGIS Server. Successfully publishing a large .vtpk as a hosted vector tile service

requires more time for your web client to communicate with ArcGIS Server. Check with your ArcGIS Server administratorto verify that The maximum time a client can use a service is set to 21,600 seconds.

The following steps walk you through the process for ArcGIS Server 10.7.1 or 10.8.

• Open a new browser and access ArcGIS Server Manager, for example, https://PORTALNAME/server/manager,and sign in.

• Click Site (root) > System > PublishingTools.

• Click Pooling on the left, and under Specify Service Timeouts, change The maximum time a client can use aservice from 3,600 seconds (1 hour) to 21600 seconds (6 hours).

• Click Save and Restart on the upper right side to save the changes.

• Sign out of ArcGIS Server Manager.



http://server.arcgis.com/en/portal/latest/administer/windows/roles.htm#ESRI_SECTION1_911D5C251A304BA08B70ABE88D5E4E94http://pro.arcgis.com/en/pro-app/get-started/about-licensing.htm#ESRI_SECTION1_4D1FDDBF325D46CE966170496F776983http://server.arcgis.com/en/server/latest/publish-services/windows/geoprocessing-service-settings-pooling-and-processes.htm#GUID-49C76E3E-4A07-4FEE-89D7-9316910A58C8

3. ArcGIS Data Appliance 7.1: OpenStreetMap Vector Basemaps is delivered on a USB flash drive loaded with vector tiles,styles, and style publishing tools. Copy all contents of the USB flash drive to your local computer.



Setup



Setup ArcGIS Data Appliance: OpenStreetMap VectorBasemapsWelcome to the ArcGIS Data Appliance: OpenStreetMap Vector Basemaps (hereafter known as OSM Vector Basemaps)setup!

For information on what's included with OSM Vector Basemaps, see What do I get with OpenStreetMap Vector Basemaps?

Before you proceed, make sure System Requirements are met.

The basic deployment workflow is as follows:

To set up OSM Vector Basemaps, you will perform the following steps:

1. Upload package to your Portal

2. Publish OSM Vector Basemap service

3. Publish Map Styles

4. Share vector style web layers

Note: OSM Vector Basemaps includes two Vector Tile Packages (.vtpk) on the flash drive.OSM_Vector_Basemap_DA71_Install.vtpk is in Web Mercator Auxillary Sphereprojection (WMA). OSM_Vector_Basemap_GCS_DA71_Install.vtpk is in WGS84(GCS) tiling scheme. The following instructions reflect the sharing process of the WMAVector Tile Package. To share the GCS package, you need to enter the correct .vtpkname for the input package as well as take the GCS naming into consideration whenpublishing the hosted tile layer. OSM Vector Basemap Styles in the GCS directoryalready take the WGS84 naming into account in the metadata files.



Upload package to your PortalFirst, you need to copy the entire USB flash drive contents to your local computer if you have not already done so. See SystemRequirements for requirements you need to meet before you start the publishing process for OSM Vector Basemaps.

1. Start ArcGIS Pro. Sign in to your Portal. Set as Active Portal.

Note: You must be signed in and connected to your Portal before you proceed. You will notbe able to enter your Portal user name and password when using the Share Packagetool later in these instructions. The tool will obtain your credentials from ArcGIS Pro.

2. Create a new project.

3. Select the Analysis tab, then select Tools.

A Geoprocessing pane appears.

4. In the Geoprocessing pane, type Share Package in the Find Tools dialog box, and select the Share Package (DataManagement Tools) option in the Search Results.



5. In the Geoprocessing pane for the Share Package tool, provide the following:a. For Input Package, type the path to the Vector Tile Package, for example,

C:\vector_tiles\Packages\OSM_Vector_Basemap_DA71_Install.vtpk.b. For Summary, type OSM World Basemap for Data Appliance 7.1.c. For Tags, type 7.1, v2.

Note: It is important that you do not modify Credits, and you do not check the boxes toshare with Everybody or Within Organization.

6. Select Run.It takes approximately 30–120 minutes to upload the package to your Portal using the Share Package tool. A "SharePackage Uploaded Successfully" message displays in the Share Package window once the upload is complete.

7. Validate, through your portal, that the .vtpk uploaded successfully in step 5.a. Open a web browser and log in to your Portal.

b. OSM_Vector_Basemap_DA71_Install is located in the root folder. Check that the Size: of the uploaded .vtpk is31,852 MB and Shared with: indicates the item is not shared.

Your item should look like this:



Note: If the size is not 31,852 MB, delete the item and upload theOSM_Vector_Basemap_DA71_Install.vtpk again. You may want to discusswith your portal administrator.For OSM_Vector_Basemap_GCS_DA71_Install.vtpk, if the size is not 31,970MB, delete the item and upload the Vector Tile Package again.

Publish OSM Vector Basemap serviceNow that you've uploaded the vector tile package to your portal, you are ready to publish the OSM Vector Basemap hosted tilelayer service from your Portal.

1. Sign in to your Portal for ArcGIS.

Note: Your account must have publishing credentials.

2. In My Content, go to the item page for the Vector Tile Package (OSM_Vector_Basemap_DA71_Install.vtpk) youpreviously uploaded to your Portal.

3. Click the Publish button, change the title to OSM_Vector_Basemap_v2, and click Publish again.

Note: For GCS, use the Vector Tile PackageOSM_Vector_Basemap_GCS_DA71_Install.vtpk. Change the title toOSM_Vector_Basemap_GCS_v2 for the hosted tile layer that gets published.

Note: It takes 30–120 minutes to create the hosted layer depending on your systemconfiguration.

OSM_Vector_Basemap_v2 Tile Layer (hosted) is created.



Publish Map StylesNow that you've published your hosted vector Tile Layer, you are ready to publish your map styles.

VectorStylePublisher.tbx (~54KB) is a geoprocessing toolbox that is run in ArcGIS Pro. This toolbox publishes new private mapitems in your Portal for five vector tile layers and transfers the vector basemap style resource folders and files and metadata forthe map item pages from your local computer to your portal.

These instructions assume the Toolbox and VectorBasemapStyles folders are on your local computer.

Note: You must have a Portal account with Publisher or Administrative Roles enabled or aArcGIS Enterprise account with a username and password.

1. Start ArcGIS Pro. Sign in to your Portal. Set as Active Portal.

2. Create a new project.

3. Select the View tab, select Catalog View, right-click Toolboxes, and select Add Toolbox.

4. Browse to the location on your local computer where you copied the contents from the USB flash drive, and selectVectorStylePublisher.tbx. Click OK.



VectorStylePublisher.tbx is added to the Toolboxes for the Project.5. Double-click Toolboxes and double-click VectorStylePublisher.tbx.

6. Double-click the Vector Style Publisher script.

7. In the Geoprocessing pane for the VectorStylePublisher tool, select the Parameters tab and provide the following:



a. For Folder containing vector styles, browse to the location of VectorBasemapStyles on your local computer, forexample, C:\Projects\OSM_Vector_Basemaps_7.1\VectorBasemapStyles\WMA_Styles\WMA.

b. For Vector Tile Service URL, type the URL of the OSM Vector Basemap hosted tile layer, for example,https://portalname.domain.com/server/rest/services/Hosted/OSM_Vector_Basemap_v2/VectorTileServer.

Note: The Vector Tile Service URL is found in the lower right of theOSM_Vector_Basemap_v2 hosted tile layer item page. Click the Copy icon andpaste onto the geoprocessing dialog box for the Vector Tile Service URL.

c. For Metadata folder name, metadata is the default folder name.



Note: If you are on a portal with PKI authentication, expand PKI Authorization byclicking the arrow on the left side. Provide the following two parameters: location ofthe PKI Certificated file (.pfx) and PKI Private Password.

If you are on a portal with Linux LDAP authentication, expand Linux LDAP byclicking the arrow on the left side. Provide the following two parameters: Sign InUsername and Sign In Password.

d. Click Run.

The five vector tile layers (map styles) are created in your assigned ArcGIS Enterprise account in Portal for ArcGIS. You canview the items under My Content. There will be seven items listed including the five vector tile layers, the .vtpk and the tilelayer (hosted).

Share vector style web layersThe items created are private unless you check the Share vector style web layers publicly box to make them public:

Or you can select the map items in your portal and change the sharing settings:



Note: Delete Protection for all items is applied upon publishing the tile layers. To change theprotection setting, open the item and click the Settings tab. Then uncheck DeleteProtection and click Save.

Once you have setup OSM Vector Basemaps, you can:

• Use OSM Vector Basemaps

• Customize styles



TroubleshootingListed below are issues you may encounter when working with OpenStreetMap (OSM) Vector Basemaps content as well asrecommended solutions.

• What if the size of the uploaded .vtpk file is not 31,852 MB for OSM_Vector_Basemap_DA71_Install.vtpk or 31,970 MB forOSM_Vector_Basemap_GCS_DA71_Install.vtpk?

• What if I encounter an error (There was an error message) when I try to publish the service?

• What do I do if the progress bars keep loading when I'm trying to publish my service?

What if the size of the uploaded .vtpk file is not 31,852 MB for OSM_Vector_Basemap_DA71_Install.vtpk or31,970 MB for OSM_Vector_Basemap_GCS_DA71_Install.vtpk?If your tile layer service did not publish successfully, you'll need to check the log using the server manager to see if there areany errors.

In some cases, the ArcGIS Pro Share Package may have reported Success, but when you check the size of the .vtpk fromthe item details page, it does not match. Here are some things that you can try to resolve this issue:

1. Upload the .vtpk again. You'll need to delete the OSM_Vector_Basemap_DA71_Install.vtpk orOSM_Vector_Basemap_GCS_DA71_Install.vtpk item on your portal first before you proceed. Next, upload theOSM_Vector_Basemap_DA71_Install.vtpk or OSM_Vector_Basemap_GCS_DA71_Install.vtpk again using theArcGIS Pro Share Package tool.

2. Verify with your portal administrator that there is at least 64 GB of disk space per .vtpk available on your portal. Makesure there is space on \arcgis\arcgisportal where the content items arestored.

3. Verify that you are using a supported version of ArcGIS Pro. See System requirements for details.

Contact Esri Support if you still cannot successfully upload the .vtpk.



https://support.esri.com/contact-tech-support

What if I encounter an error (There was an error message) when I try to publish the service?

Work with your system administrator to check the ArcGIS Server Manager logs.

If there is an error due to a geoprocessing service (PublishingTools) timing out or crashing, you may have skipped a Systemrequirements step. Verify that you've changed the default value of The maximum time a client can use a service to 21,600seconds.

Once you have updated the geoprocessing service maximum time, perform the following steps:

1. In your server, delete the OSM_Vector_Basemap_v2 tile layer (hosted) or OSM_Vector_Basemap_GCS_v2 tile layer(hosted).

2. On the ArcGIS Server machine, delete the job in the following folder: \arcgis\arcgisserver\directories\arcgisjobs\system\publishingtools_gpserver\ folder

Note: You can find the job ID in the log file.

3. Restart the server.

4. Verify that you have at least 64 GB of available space per .vtpk on the ArcGIS Server.5. In your portal, publish the OSM_Vector_Basemap_v2 or OSM_Vector_Basemap_GCS_v2 tile layer again.



What do I do if the progress bars keep loading when I'm trying to publish my service?

If the Creating Service animated bars continue to load after two hours, the browser connection to the portal may have failed.

You can sign out of the portal and sign in again to see if the thumbnail has changed to the Data Appliance 7.1 icon, becausethe browser connection does not affect the creation of the service.

If the thumbnail changes to the Data Appliance 7.1 icon, verify that the map displays as expected.



Other resourcesThe following resources are available for OpenStreetMap (OSM) Vector Basemaps.

ResourcesArcGIS Data Appliance 7.1: OSM Vector Basemaps help [PDF]

ArcGIS Data Appliance 7.1: Esri Vector Basemaps New users video [MP4] demonstrating uploading and publishing Esri VectorBasemaps to your portal—Instructions for uploading and publishing OSM Vector Basemaps are similar to Esri VectorBasemaps. The names of the files and styles used in the video reflect the source data. Substitute OpenStreetMap (OSM) filenames for Esri Vector Basemaps file names when following the instructions in the video.

Tile layers, Customize basemaps and Choose basemap in the Portal for ArcGIS help

Working with and Customizing Esri Vector Basemaps: The basics

Style a vector basemap using the ArcGIS Vector Style Editor in the ArcGIS for Developers website (for ArcGIS 10.8 users only)



https://downloads.esri.com/esri_content_doc/da/data_appliance_71_osm_vector_basemaps.pdfhttps://links.esri.com/data-appliance/7.1/vb-nu-videohttps://enterprise.arcgis.com/en/portal/latest/use/tile-layers.htmhttps://enterprise.arcgis.com/en/portal/latest/administer/windows/customize-basemaps.htmhttps://enterprise.arcgis.com/en/portal/latest/use/choose-basemap.htmhttps://www.esri.com/arcgis-blog/products/arcgis-living-atlas/mapping/working-with-and-customizing-esri-vector-basemaps-the-basics/https://developers.arcgis.com/labs/arcgisonline/style-a-vector-basemap/

Use



Use OSM Vector BasemapsHere are some ways to use Open StreetMap (OSM) Vector Basemaps in your Esri applications.

• The five map tile layers (styles) can be added to a map in ArcGIS Pro or to the Map Viewer in Portal for ArcGIS.

• The tile layers (styles) can be added to an existing basemap, or they can be added as the basemap.



• Three of the five map tile layers (styles) are designed to be used with a raster layer—World Hillshade or World Imagery asthe basemap in their web map.▪ OpenStreetMap (with Relief)—World Hillshade

▪ OpenStreetMap (Esri Street with Relief style)—World Hillshade

▪ OpenStreetMap (Esri Hybrid Reference style)—World Imagery

• If you have a tile layer (style) in your map, it can be moved to the basemap.



• Hybrid Reference layer can be moved to the basemap and set as the Reference layer over the World Imagery layer.



Customize stylesArcGIS Data Appliance: OpenStreetMap Vector Basemaps provides you with the ability to modify and customize the map style.You can customize the map by changing the hex color codes of map features or labels, removing entire feature classes,changing fonts (face, size, color), or by making other edits. For more information, see the vector basemap blog post on theArcGIS Blog website.

Customization requires changes to the map style's resources\styles\root.json file. There are two main ways tocustomize your maps: add a style to the map in Map Viewer or copy a root.json style from the USB flash drive. If you areusing ArcGIS Enterprise 10.8, you can use the new Vector Tile Style Editor. Then you can edit the custom style map item toinclude a new thumbnail and update the item's information for your custom style.

Add a style to the map in Map Viewer and rename the style1. In your Portal for ArcGIS, open the style you want to customize in Map Viewer, for example, OpenStreetMap.

2. Click More Options , and select Copy.

A new OpenStreetMap - Copy layer is added to the top of the Contents pane.

3. Click More Options , and select Save Layer.



https://www.esri.com/arcgis-blog/products/arcgis-living-atlas/mapping/working-with-and-customizing-esri-vector-basemaps-the-basics/

4. Rename the style, for example, Custom OpenStreetMap, and select the Portal for ArcGIS folder where you want to savethe new style.

5. In My Content, go to the item page for the new style, and click the Download style button.

The style (root.json file) is saved to your computer.6. Open the root.json file in a text editor such as Adobe Brackets or Notepad++, and edit and save the file. Edits to the

root.json file can be color value, line width, font size, and so on.7. Validate the JSON using https://jsonlint.com/ or a similar JSON validation tool. You can also use this website to parse the

JSON into a more user-friendly format before editing.

8. On the item page for the new style, click the Update button to update the item and load the modified root.json file fromyour computer to your Portal for ArcGIS.



https://jsonlint.com/

Copy a style from the USB flash drive and rename the map style directory1. On your local computer, create a directory called CustomStyles at the same directory level as the GCS and WMA

directories.

2. Copy a style from the USB flash drive and rename the map style directory, for example, copy the openstreetmap directoryinto a new directory and change the name to customopenstreetmap.

3. In the new customopenstreetmap directory, open the resources\styles\root.json file (for example,CustomStyles\customopenstreetmap\resources\styles\root.json) in a text editor such as Adobe Brackets orNotepad++, and edit the map code and save the file.An example of a style edit in the root.json file is changing the country boundary in purple (#AC46AC) to red (#FF0000).

4. In the new customopenstreetmap directory, open the metadata\metadata.json file (for example, CustomStyles\customopenstreetmap\metadata\metadata.json) in a text editor such as Adobe Brackets or Notepad++, and editthe "title": replacing "OpenStreetMap" with a new map title, for example, "Custom OpenStreetMap", and savethe file.



5. Validate the JSON using https://jsonlint.com/ or a similar JSON validation tool.

6. Perform the Publish Map Styles steps, this time pointing to the new directory containing your custom style.

The new style is created in your Portal for ArcGIS under My Content. Following the naming conventions in steps 1–4 producesa new item in your portal named Custom OpenStreetMap.

Edit the custom style map item in your Portal for ArcGISOn the map item page of your custom map style, you can update the summary, description, tags, and thumbnail to betterdescribe the new map you styled.



https://jsonlint.com/

Esri Vector Tile Style EditorArcGIS Enterprise 10.8 users can customize vector map styles through an app in the map viewer. Access the Style Editor fromthe Change Style button under any Esri Vector Basemap Tile Layer. Save the new style to your portal.

Styling options include the Quick Edit tool, in which layers are customized across groups of features, and the Layer StyleEditor list for individual feature style controls. Colors, line weights, font faces, and sprite symbology are examples of the stylechanges that can be applied to your custom map item.



Information about using the ArcGIS Vector Style Editor to style a vector basemap is available in the ArcGIS for Developerswebsite.



https://developers.arcgis.com/labs/arcgisonline/style-a-vector-basemap/

Terms of use



Terms of use for ArcGIS Data Appliance: OpenStreetMapVector BasemapsArcGIS Data Appliance: OpenStreetMap Vector Basemaps should only be served up from ArcGIS Server and Portal forArcGIS (10.7.1 or 10.8). ArcGIS Data Appliance: OpenStreetMap Vector Basemaps cannot be transferred and used withnon-Esri technology.

For more information, see the Master License Agreement on the Esri website.



https://www.esri.com/legal/software-license

Copyright informationCopyright © 1995-2019 Esri. All rights reserved. Published in the United States of America.

You may have received Products or Services that include Graph Editor Toolkit, Copyright © 1992-1999 Tom Sawyer Software,Berkeley, California, All Rights Reserved, and Tom Sawyer Visualization, Ver. 8.0 Copyright © 1992-2009 Tom SawyerSoftware, Berkeley, California, All Rights Reserved. Portions of this computer program are Copyright © 1995-2016 Celartem,Inc., dba LizardTech. All rights reserved. This application supports the ECW data format and ECWP compression protocols.Portions of this computer program are Copyright © 2007-2015 Intergraph Corporation. All rights reserved. Creatingcompressed files using ECW technology is protected by one or more of U.S. Patent No. 6,201,897, No. 6,442,298, and No.6,633,688.

Third Party OSS-FOSS Acknowledgement DocumentsEsri's use of open source software libraries is disclosed in the Third Party OSS-FOSS Acknowledgement Documents found athe link below.

https://links.esri.com/open-source-acknowledgments

ArcGIS Notebooks make use of The FreeType Project, following The FreeType Project License.

US GOVERNMENT CUSTOMERThe Products are commercial items, developed at private expense, provided to Customer under this Master Agreement. IfCustomer is a US government entity or US government contractor, Esri licenses or provides subscriptions to Customer inaccordance with this Master Agreement under FAR Subparts 12.211/12.212 or DFARS Subpart 227.7202. Esri Data andOnline Services are licensed or subscribed under the same DFARS Subpart 227.7202 policy as commercial computer softwarefor acquisitions made under DFARS. Products are subject to restrictions, and this Master Agreement strictly governsCustomer's use, modification, performance, reproduction, release, display, or disclosure of Products. Agreement provisionsthat are inconsistent with federal law regulation will not apply. A US government Customer may transfer Software to any of itsfacilities to which it transfers the computer(s) on which it has installed such Software. If any court, arbitrator, or board holds thata US government Customer has greater rights to any portion of the Products under applicable public procurement law, suchrights will extend only to the portions affected. Online Services are FedRAMP Tailored-Low authorized but do not meet highersecurity requirements including those found in DFARS 252.239-7010.

Esri [email protected], 3D Analyst, Address Coder, ArcAtlas, ArcCAD, ArcCatalog, ArcCOGO, ArcData, ArcDoc, ArcEdit, ArcEditor,ArcEurope, ArcExplorer, ArcExpress, ArcGIS, ArcGlobe, ArcGrid, ArcIMS, ARC/INFO, ArcInfo, ArcInfo Librarian, ArcLessons,ArcLocation, ArcLogistics, ArcMap, ArcNetwork, ArcNews, ArcObjects, ArcOpen, ArcPad, ArcPlot, ArcPress, ArcPy,ArcReader, ArcScan, ArcScene, ArcSchool, ArcScripts, ArcSDE, ArcSdl, ArcSketch, ArcStorm, ArcSurvey, ArcTIN,ArcToolbox, ArcTools, ArcUSA, ArcUser, ArcView, ArcVoyager, ArcWatch, ArcWeb, ArcWorld, ArcXML, AtlasGIS, AtlasWare,Avenue, BAO, Business Analyst, Business Analyst Online, BusinessMAP, CityEngine, CommunityInfo, Database Integrator,DBI Kit, Drone2Map, EDN, Esri, Esri-Team GIS, Esri-The GIS Company, Esri-The GIS People, Esri-The GIS Software Leader,FormEdit, GeoCollector, Geographic Design System, Geography Matters, Geography Network, GIS by Esri, GIS Day, GIS forEveryone, GISData Server, JTX, Maplex, MapObjects, MapStudio, ModelBuilder, MOLE, MPS-Atlas, PLTS, Rent-a-Tech, SDE,SML, Sourcebook·America, SpatiaLABS, Spatial Database Engine, StreetMap, Tapestry, The Science of Where, See WhatOthers Can't, the ARC/INFO logo, the ArcGIS Explorer logo, the Esri globe logo, the Esri Press logo, the GIS Day logo, Water



https://links.esri.com/open-source-acknowledgmentshttps://git.savannah.gnu.org/cgit/freetype/freetype2.git/tree/docs/FTL.TXT

Writes, www.arcgis.com, www.esri.com, www.gisday.com, are trademarks, service marks, or registered marks in the UnitedStates, the European Community, or certain other jurisdictions.

Other companies and products or services mentioned herein may be trademarks, service marks or registered marks of theirrespective mark owners.



Support



SupportSupport for ArcGIS Data Appliance: OpenStreetMap Vector Basemaps is provided by the Esri technical support team.

Contact the following:• United States users—Support is provided by Esri Technical Support. Use the following contact options:

▪ Phone: 888-377-4575

▪ Email: [email protected]

▪ Web page: http://support.esri.com/contact-tech-support

▪ Hours: Monday through Friday, 5:00 a.m. to 5:00 p.m. (Pacific time), excluding Esri holidays

• International users—Support is provided by your local Esri distributor.



http://support.esri.com/contact-tech-supporthttp://www.esri.com/about-esri/contact.html

Table of ContentsGet startedWhat are ArcGIS Data Appliance: OpenStreetMap Vector Basemaps?What do I get with OpenStreetMap Vector Basemaps?Directory of map stylesFrequently asked questions

System requirementsOSM Vector Basemaps system requirements

SetupSetup ArcGIS Data Appliance: OpenStreetMap Vector BasemapsTroubleshootingOther resources

UseUse OSM Vector BasemapsCustomize styles

Terms of useTerms of use for ArcGIS Data Appliance: OpenStreetMap Vector BasemapsCopyright information

SupportSupport