From 227832bd389fda4e09979b888a7aef4d52e3e2f6 Mon Sep 17 00:00:00 2001 From: Nathan Castle Date: Wed, 8 Aug 2018 11:34:01 -0700 Subject: [PATCH] Update readmes for sample changes --- src/Android/README.md | 26 +++++++++++----- .../Layers/SceneLayerSelection/readme.md | 9 ++++++ .../Samples/Layers/WmsIdentify/README.md | 2 +- src/Forms/README.md | 26 +++++++++++----- .../Samples/Layers/WmsIdentify/README.md | 2 +- .../Samples/Layers/WmsIdentify/README.md | 2 +- src/UWP/README.md | 26 +++++++++++----- .../Samples/Layers/WmsIdentify/README.md | 2 +- src/WPF/README.md | 30 ++++++++++++++----- src/iOS/README.md | 26 +++++++++++----- .../Layers/SceneLayerSelection/readme.md | 9 ++++++ .../Samples/Layers/WmsIdentify/README.md | 2 +- 12 files changed, 122 insertions(+), 40 deletions(-) create mode 100644 src/Android/Xamarin.Android/Samples/Layers/SceneLayerSelection/readme.md create mode 100644 src/iOS/Xamarin.iOS/Samples/Layers/SceneLayerSelection/readme.md diff --git a/src/Android/README.md b/src/Android/README.md index be65943ee2..1a2af5f47b 100644 --- a/src/Android/README.md +++ b/src/Android/README.md @@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi * [Buffer list](Xamarin.Android/Samples/Geometry/BufferList) -This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided. +This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output. * [Clip geometry](Xamarin.Android/Samples/Geometry/ClipGeometry) @@ -331,6 +331,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image. +* [Scene layer selection](Xamarin.Android/Samples/Layers/SceneLayerSelection) + +This sample demonstrates how to identify geoelements in a scene layer. + * [Show labels on layer](Xamarin.Android/Samples/Layers/ShowLabelsOnLayer) This sample demonstrates how to show labels on a feature layer @@ -501,6 +505,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent. +## Security + +* [ArcGIS token challenge](Xamarin.Android/Samples/Security/TokenSecuredChallenge) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [ArcGIS token with a known user](Xamarin.Android/Samples/Security/TokenSecuredKnownUser) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [Authenticate with OAuth](Xamarin.Android/Samples/Security/OAuth) + +This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example). + ## Symbology * [Distance composite symbol](Xamarin.Android/Samples/Symbology/UseDistanceCompositeSym) @@ -527,9 +545,3 @@ This sample demonstrates how to create a simple renderer and add it to a graphic This sample demonstrate how to use a unique value renderer to style different features in a feature layer with different symbols. Features do not have a symbol property for you to set, renderers should be used to define the symbol for features in feature layers. The unique value renderer allows for separate symbols to be used for features that have specific attribute values in a defined field. -## Tutorial - -* [Author, edit, and save a map](Xamarin.Android/Samples/Tutorial/AuthorEditSaveMap) - -This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/android/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login. - diff --git a/src/Android/Xamarin.Android/Samples/Layers/SceneLayerSelection/readme.md b/src/Android/Xamarin.Android/Samples/Layers/SceneLayerSelection/readme.md new file mode 100644 index 0000000000..6ff851b0f2 --- /dev/null +++ b/src/Android/Xamarin.Android/Samples/Layers/SceneLayerSelection/readme.md @@ -0,0 +1,9 @@ +# Scene layer selection + +This sample demonstrates how to identify geoelements in a scene layer. + + + +## Instructions + +Tap/Click on a building in the scene layer to identify it. diff --git a/src/Android/Xamarin.Android/Samples/Layers/WmsIdentify/README.md b/src/Android/Xamarin.Android/Samples/Layers/WmsIdentify/README.md index ad235d77c7..217650b9fd 100644 --- a/src/Android/Xamarin.Android/Samples/Layers/WmsIdentify/README.md +++ b/src/Android/Xamarin.Android/Samples/Layers/WmsIdentify/README.md @@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated ## Instructions -Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note that due to the nature of the WMS service implementation, an empty result is shown when there is no result; an application might inspect the HTML to determine if the HTML actually contains a feature. +Tap to identify a feature. Note: the service returns HTML regardless of whether there was an identify result. See the Forms implementation for an example heuristic for identifying empty results. diff --git a/src/Forms/README.md b/src/Forms/README.md index f201ac1a09..fb2affbea8 100644 --- a/src/Forms/README.md +++ b/src/Forms/README.md @@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi * [Buffer list](Shared/Samples/Geometry/BufferList) -This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided. +This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output. * [Clip geometry](Shared/Samples/Geometry/ClipGeometry) @@ -331,6 +331,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image. +* [Scene layer selection](Shared/Samples/Layers/SceneLayerSelection) + +This sample demonstrates how to identify geoelements in a scene layer. + * [Show labels on layer](Shared/Samples/Layers/ShowLabelsOnLayer) This sample demonstrates how to show labels on a feature layer @@ -501,6 +505,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent. +## Security + +* [ArcGIS token challenge](Shared/Samples/Security/TokenSecuredChallenge) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [ArcGIS token with a known user](Shared/Samples/Security/TokenSecuredKnownUser) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [Authenticate with OAuth](Shared/Samples/Security/OAuth) + +This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example). + ## Symbology * [Distance composite symbol](Shared/Samples/Symbology/UseDistanceCompositeSym) @@ -527,9 +545,3 @@ This sample demonstrate how to use a unique value renderer to style different fe This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code. -## Tutorial - -* [Author, edit, and save a map](Shared/Samples/Tutorial/AuthorEditSaveMap) - -This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/forms/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login. - diff --git a/src/Forms/Shared/Samples/Layers/WmsIdentify/README.md b/src/Forms/Shared/Samples/Layers/WmsIdentify/README.md index f394edbfb0..246a7b74fd 100644 --- a/src/Forms/Shared/Samples/Layers/WmsIdentify/README.md +++ b/src/Forms/Shared/Samples/Layers/WmsIdentify/README.md @@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated ## Instructions -Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results. +Tap to identify a feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to not show empty results. diff --git a/src/UWP/ArcGISRuntime.UWP.Viewer/Samples/Layers/WmsIdentify/README.md b/src/UWP/ArcGISRuntime.UWP.Viewer/Samples/Layers/WmsIdentify/README.md index f394edbfb0..20140f7b85 100644 --- a/src/UWP/ArcGISRuntime.UWP.Viewer/Samples/Layers/WmsIdentify/README.md +++ b/src/UWP/ArcGISRuntime.UWP.Viewer/Samples/Layers/WmsIdentify/README.md @@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated ## Instructions -Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results. +Tap a feature to identify. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results. diff --git a/src/UWP/README.md b/src/UWP/README.md index 94dfae0206..9e7323da08 100644 --- a/src/UWP/README.md +++ b/src/UWP/README.md @@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi * [Buffer list](ArcGISRuntime.UWP.Viewer/Samples/Geometry/BufferList) -This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided. +This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output. * [Clip geometry](ArcGISRuntime.UWP.Viewer/Samples/Geometry/ClipGeometry) @@ -327,6 +327,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image. +* [Scene layer selection](ArcGISRuntime.UWP.Viewer/Samples/Layers/SceneLayerSelection) + +This sample demonstrates how to identify geoelements in a scene layer. + * [Show labels on layer](ArcGISRuntime.UWP.Viewer/Samples/Layers/ShowLabelsOnLayer) This sample demonstrates how to show labels on a feature layer @@ -497,6 +501,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent. +## Security + +* [ArcGIS token challenge](ArcGISRuntime.UWP.Viewer/Samples/Security/TokenSecuredChallenge) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [ArcGIS token with a known user](ArcGISRuntime.UWP.Viewer/Samples/Security/TokenSecuredKnownUser) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [Authenticate with OAuth](ArcGISRuntime.UWP.Viewer/Samples/Security/OAuth) + +This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example). + ## Symbology * [Distance composite symbol](ArcGISRuntime.UWP.Viewer/Samples/Symbology/UseDistanceCompositeSym) @@ -523,9 +541,3 @@ This sample demonstrate how to use a unique value renderer to style different fe This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code. -## Tutorial - -* [Author, edit, and save a map](ArcGISRuntime.UWP.Viewer/Samples/Tutorial/AuthorEditSaveMap) - -This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/uwp/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login. - diff --git a/src/WPF/ArcGISRuntime.WPF.Viewer/Samples/Layers/WmsIdentify/README.md b/src/WPF/ArcGISRuntime.WPF.Viewer/Samples/Layers/WmsIdentify/README.md index f394edbfb0..20140f7b85 100644 --- a/src/WPF/ArcGISRuntime.WPF.Viewer/Samples/Layers/WmsIdentify/README.md +++ b/src/WPF/ArcGISRuntime.WPF.Viewer/Samples/Layers/WmsIdentify/README.md @@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated ## Instructions -Tap or click on a feature. A callout appears with the returned content for the WMS feature. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results. +Tap a feature to identify. Note: the service returns HTML regardless of whether there was an identify result. The sample uses a heuristic to hide empty results. diff --git a/src/WPF/README.md b/src/WPF/README.md index c65894813f..898c10c251 100644 --- a/src/WPF/README.md +++ b/src/WPF/README.md @@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi * [Buffer list](ArcGISRuntime.WPF.Viewer/Samples/Geometry/BufferList) -This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided. +This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output. * [Clip geometry](ArcGISRuntime.WPF.Viewer/Samples/Geometry/ClipGeometry) @@ -327,6 +327,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image. +* [Scene layer selection](ArcGISRuntime.WPF.Viewer/Samples/Layers/SceneLayerSelection) + +This sample demonstrates how to identify geoelements in a scene layer. + * [Show labels on layer](ArcGISRuntime.WPF.Viewer/Samples/Layers/ShowLabelsOnLayer) This sample demonstrates how to show labels on a feature layer @@ -425,6 +429,10 @@ This sample demonstrates loading a webmap in a map from a Uri. This sample demonstrates how to open a mobile map from a map package. +* [Open scene (Portal item)](ArcGISRuntime.WPF.Viewer/Samples/Map/OpenScene) + +This sample demonstrates how to open a scene from a Portal item. Just like Web Maps are the ArcGIS format for maps, Web Scenes are the ArcGIS format for scenes. These scenes can be stored in ArcGIS Online or Portal. + * [Search a portal for maps](ArcGISRuntime.WPF.Viewer/Samples/Map/SearchPortalMaps) This sample demonstrates searching a portal for web maps and loading them in the map view. You can search ArcGIS Online public web maps using tag values or browse the web maps in your account. OAuth is used to authenticate with ArcGIS Online to access items in your account. @@ -519,6 +527,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent. +## Security + +* [ArcGIS token challenge](ArcGISRuntime.WPF.Viewer/Samples/Security/TokenSecuredChallenge) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [ArcGIS token with a known user](ArcGISRuntime.WPF.Viewer/Samples/Security/TokenSecuredKnownUser) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [Authenticate with OAuth](ArcGISRuntime.WPF.Viewer/Samples/Security/OAuth) + +This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example). + ## Symbology * [Distance composite symbol](ArcGISRuntime.WPF.Viewer/Samples/Symbology/UseDistanceCompositeSym) @@ -545,9 +567,3 @@ This sample demonstrate how to use a unique value renderer to style different fe This sample demonstrates how to create a simple renderer and add it to a graphics overlay. Renderers define the symbology for all graphics in a graphics overlay (unless they are overridden by setting the symbol directly on the graphic). Simple renderers can also be defined on feature layers using the same code. -## Tutorial - -* [Author, edit, and save a map](ArcGISRuntime.WPF.Viewer/Samples/Tutorial/AuthorEditSaveMap) - -This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/wpf/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login. - diff --git a/src/iOS/README.md b/src/iOS/README.md index e7438b101c..9c63e3e59e 100644 --- a/src/iOS/README.md +++ b/src/iOS/README.md @@ -109,7 +109,7 @@ Creating buffers is a core concept in GIS proximity analysis, allowing you to vi * [Buffer list](Xamarin.iOS/Samples/Geometry/BufferList) -This sample demonstrates how to use the GeometryEngine.Buffer to generate one or more polygon from a series of input geometries and matching series of buffer distances. The option to union all the resulting buffer(s) is provided. +This sample demonstrates how to use a planar (Euclidean) buffer operation by calling `GeometryEngine.Buffer` to generate one or more polygons from a collection of input geometries and a corresponding collection of buffer distances. The result polygons can be returned as individual geometries or unioned into a single polygon output. * [Clip geometry](Xamarin.iOS/Samples/Geometry/ClipGeometry) @@ -331,6 +331,10 @@ This sample demonstrates how to create an `ImageServiceRaster`, fetch the `Rende This sample demonstrates how to use an RGB renderer on a raster layer. An RGB renderer is used to adjust the color bands of a multi-spectral image. +* [Scene layer selection](Xamarin.iOS/Samples/Layers/SceneLayerSelection) + +This sample demonstrates how to identify geoelements in a scene layer. + * [Show labels on layer](Xamarin.iOS/Samples/Layers/ShowLabelsOnLayer) This sample demonstrates how to show labels on a feature layer @@ -501,6 +505,20 @@ This sample demonstrates how you can use the LocatorTask API to geocode an addre This sample demonstrates how to use geocode functionality to search for points of interest, around a location or within an extent. +## Security + +* [ArcGIS token challenge](Xamarin.iOS/Samples/Security/TokenSecuredChallenge) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [ArcGIS token with a known user](Xamarin.iOS/Samples/Security/TokenSecuredKnownUser) + +This sample demonstrates how to authenticate with ArcGIS Server using ArcGIS Tokens to access a secure service. Accessing secured services requires a login that's been defined on the server. + +* [Authenticate with OAuth](Xamarin.iOS/Samples/Security/OAuth) + +This sample demonstrates how to authenticate with ArcGIS Online (or your own portal) using OAuth2 to access a secure web map (or the secured layers it contains). Accessing secured items requires a login on the portal (an ArcGIS Online account, for example). + ## Symbology * [Distance composite symbol](Xamarin.iOS/Samples/Symbology/UseDistanceCompositeSym) @@ -527,9 +545,3 @@ This sample demonstrates how to create a simple renderer and add it to a graphic This sample demonstrate how to use a unique value renderer to style different features in a feature layer with different symbols. Features do not have a symbol property for you to set, renderers should be used to define the symbol for features in feature layers. The unique value renderer allows for separate symbols to be used for features that have specific attribute values in a defined field. -## Tutorial - -* [Author, edit, and save a map](Xamarin.iOS/Samples/Tutorial/AuthorEditSaveMap) - -This sample demonstrates how to author and save a map as an ArcGIS portal item (web map). It is also the solution to the [Author, edit, and save maps to your portal tutorial](https://developers.arcgis.com/net/latest/ios/guide/author-edit-and-save-maps-to-your-portal.htm). Saving a map to arcgis.com requires an ArcGIS Online login. - diff --git a/src/iOS/Xamarin.iOS/Samples/Layers/SceneLayerSelection/readme.md b/src/iOS/Xamarin.iOS/Samples/Layers/SceneLayerSelection/readme.md new file mode 100644 index 0000000000..6ff851b0f2 --- /dev/null +++ b/src/iOS/Xamarin.iOS/Samples/Layers/SceneLayerSelection/readme.md @@ -0,0 +1,9 @@ +# Scene layer selection + +This sample demonstrates how to identify geoelements in a scene layer. + + + +## Instructions + +Tap/Click on a building in the scene layer to identify it. diff --git a/src/iOS/Xamarin.iOS/Samples/Layers/WmsIdentify/README.md b/src/iOS/Xamarin.iOS/Samples/Layers/WmsIdentify/README.md index a623b929ef..217650b9fd 100644 --- a/src/iOS/Xamarin.iOS/Samples/Layers/WmsIdentify/README.md +++ b/src/iOS/Xamarin.iOS/Samples/Layers/WmsIdentify/README.md @@ -6,4 +6,4 @@ This sample demonstrates how to identify WMS features and display the associated ## Instructions -Tap to identify a features. Note that due to the nature of the WMS service implementation, an empty result is shown when there is no result; an application might inspect the HTML to determine if the HTML actually contains a feature. +Tap to identify a feature. Note: the service returns HTML regardless of whether there was an identify result. See the Forms implementation for an example heuristic for identifying empty results.