Managing KML network links

A KML network link is a way of publishing geographic data on your server using a compressed form of Keyhole Markup Language called KMZ. KML network links can be consumed by any client that supports KML, such as ArcGIS Explorer or Google Earth.

In ArcGIS Server Manager, you can use the Applications tab to view the current list of network links available on your server. To add network links to your server, you have two options:

Creating a KML network link from a map service

ArcGIS Server supports creating KML network links from existing map services. Each network link that you create is based on the KML capability associated with the map service. Therefore, if you want to create a network link from a map service, you must enable the KML capability for the service. Learn more about the KML capability

You can create KML network links that include both vector and image layers contained in the map service. Vector layers can be rasterized or returned as folders of placemarks within the KML.

A network link has several properties to define it. Some of these include:

Manager allows you to choose the layers of information to be included in the network link. Network links created in Manager do not include any information about the Refresh Parameters or the View.

Manager only provides support for creating network links that are based directly on published map services. If you want to create more KML documents or links that are more complex than those provided by Manager—for instance, if you want to include folders of links or set the View for a network link—you can use Google Earth to author KML links that embed the links you've created with Manager. Once you've created an embedded or enhanced link in Google Earth, you can save it as KMZ, then use Manager to publish it back to your server.

How to create a new KML network link from a map service

Follow these steps to create a new KML network link:

  1. In Manager, click the Applications tab.
  2. On the left, click KML Network Links
  3. Click Create Network Link.
  4. Specify the name of your link (the name will be embedded in the Name tag in the file and will also be used as the file name). Optionally provide a short and long description. The long description allows embedded HTML tags and URLs.
  5. Select the map service for which you want to create a network link. Map services without the KML capability enabled are not available.
  6. Check the layers from the service that you want to include in your network link. By default, all layers are checked.
  7. Specify how the layers should draw.
  8. Optionally, use Google Earth to edit the link, enhance its properties, or embed it within a new link. You can save the enhanced link as KMZ, then use the steps below to publish it back to your server.

Note: If you do not set the refresh interval in Google Earth to “On Request” or “After camera stops” data will not be retrieved when the Network Link is first added to Google Earth. If you do not set a view, the bounding box request sent to the KML Service will be for the default extent of the source map document. This may be a very large area and the data returned will be of very low resolution. It is best to set these two parameters in Google Earth, then save the changes and upload the enhanced network link back to your server using the steps listed below.

Publishing an existing KML network link

In addition to creating a KML Network Link, you can publish an existing network link file that was created externally; for example, in Google Earth.

  1. In Manager, click the Applications tab.
  2. On the left, click KML Network Links.
  3. Click Publish Network Link.
  4. Browse to the KML network link (.kmz or .kml) and click Upload. The name of the KMZ or KML file will be used to populate the Name column in the list of KML network links.
  5. Optionally, click Upload another file to publish another link. Otherwise, click Return to list.

Publishing an existing link in this way copies the KMZ file to the server. The original, local copy of the KMZ is not affected. It is possible to simply copy a KMZ file directly into the http://myserver/arcgis/KML folder. Manager will automatically list the file.