{"id":631042,"date":"2019-10-15T10:21:23","date_gmt":"2019-10-15T17:21:23","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=631042"},"modified":"2021-02-22T12:21:42","modified_gmt":"2021-02-22T20:21:42","slug":"introducing-the-nearby-sample-app","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app","title":{"rendered":"Introducing the Nearby sample app"},"author":7721,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[37101],"tags":[758832,25091,758822,480102,25111],"industry":[],"product":[36621],"class_list":["post-631042","blog","type-blog","status-publish","format-standard","hentry","category-announcements","tag-appstudio-sample","tag-geocoding","tag-native-app","tag-nearby","tag-routing","product-appstudio"],"acf":{"short_description":"New native sample app to find nearest places of interest (POI), filter by category and get directions from current location.","flexible_content":[{"acf_fc_layout":"content","content":"

We are excited to announce the release of a new sample app – Nearby <\/strong>– available today in AppStudio for ArcGIS! This sample showcases how to find the nearest places of interest worldwide, filter them by category, and provide step-by-step directions from your current location. Give this new app a spin using the AppStudio Player<\/a> (readily available to run in the Samples tab) on your favorite mobile phone or tablet.<\/p>\n

The source code for this sample app is available for you to inspect and customize further in AppStudio Desktop (4.0 and above)<\/a> along with all the other great sample apps. Just open Desktop, click on the New App<\/span><\/em> button, and either browse or type Nearby in the search box to find the sample and click Create<\/em>.<\/span><\/p>\n"},{"acf_fc_layout":"content","content":"

Feature highlights<\/strong><\/h3>\n

On start, the app finds generic places of interests (ten at the most), such as restaurants and libraries, which are located within a 20-mile radius of the device\u2019s location. The user is then presented with a list of found places sorted by distance.<\/p>\n

Selecting any of these places from the list will highlight the location on a map and show the place\u2019s details, and an option to view routing directions from the device\u2019s to the location. Moreover, as the places are also shown on the map, the user is able to select any place on the map to view detailed information and routing directions to the selected place.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631242,"id":631242,"title":"nearby-initial-1","filename":"nearby-initial-1.gif","filesize":431028,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/nearby-initial-1","alt":"Nearby sample app- show place's details","author":"7721","description":"","caption":"Nearby sample app- show place's details","name":"nearby-initial-1","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:45","modified":"2019-10-09 17:11:50","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":768,"height":576,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","medium-width":348,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","medium_large-width":768,"medium_large-height":576,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","large-width":768,"large-height":576,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","1536x1536-width":768,"1536x1536-height":576,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","2048x2048-width":768,"2048x2048-height":576,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1-620x465.gif","card_image-width":620,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-initial-1.gif","wide_image-width":768,"wide_image-height":576}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

When the user taps on \u201cDirections\u201d, a route to the selected place is shown on the map as well as turn-by-turn directions. By default, the sample shows driving directions, and we added an option to switch between walking and driving directions as shown in the graphic below.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631232,"id":631232,"title":"nearby-routing-2","filename":"nearby-routing-2.gif","filesize":311261,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/nearby-routing-2","alt":"Nearby sample - show direction","author":"7721","description":"","caption":"Nearby sample - show direction","name":"nearby-routing-2","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:40","modified":"2019-10-09 18:50:22","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":768,"height":576,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","medium-width":348,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","medium_large-width":768,"medium_large-height":576,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","large-width":768,"large-height":576,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","1536x1536-width":768,"1536x1536-height":576,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","2048x2048-width":768,"2048x2048-height":576,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2-620x465.gif","card_image-width":620,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-routing-2.gif","wide_image-width":768,"wide_image-height":576}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Geocoding<\/strong><\/h3>\n

The sample demonstrates the power of Esri’s Geocoding Service by providing an intuitive experience for searching nearby places by names, addresses, or categories<\/a>. The user can search by taping on a category as shown below, and they will be presented with up to ten nearby places matching the selected category.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631222,"id":631222,"title":"nearby-search+library-3","filename":"nearby-searchlibrary-3.gif","filesize":443553,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/nearby-searchlibrary-3","alt":"Nearby sample -search by taping on a category","author":"7721","description":"","caption":"Nearby sample -search by taping on a category","name":"nearby-searchlibrary-3","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:34","modified":"2019-10-09 18:50:32","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":768,"height":576,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","medium-width":348,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","medium_large-width":768,"medium_large-height":576,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","large-width":768,"large-height":576,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","1536x1536-width":768,"1536x1536-height":576,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","2048x2048-width":768,"2048x2048-height":576,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3-620x465.gif","card_image-width":620,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-searchlibrary-3.gif","wide_image-width":768,"wide_image-height":576}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

The sample also allows the user to search by typing a name or an address. As the user types, a list of suggestions based on the user\u2019s input and the device\u2019s location will be shown for the user to choose from. When a user confirms their search input or chooses from the suggestions, places matching their selection will be shown as a list and as points on the map.<\/p>\n

 <\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631212,"id":631212,"title":"nearby-location+search-4","filename":"nearby-locationsearch-4.gif","filesize":250112,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/nearby-locationsearch-4","alt":"Nearby sample - search by typing a name or an address","author":"7721","description":"","caption":"Nearby sample - search by typing a name or an address","name":"nearby-locationsearch-4","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:29","modified":"2019-10-09 18:51:28","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":768,"height":576,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","medium-width":348,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","medium_large-width":768,"medium_large-height":576,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","large-width":768,"large-height":576,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","1536x1536-width":768,"1536x1536-height":576,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","2048x2048-width":768,"2048x2048-height":576,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4-620x465.gif","card_image-width":620,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/nearby-locationsearch-4.gif","wide_image-width":768,"wide_image-height":576}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Accessing the device’s location and network<\/strong><\/h3>\n

The release of AppStudio 4.0 brought great new additions\u00a0including the PermissionDialog QML component,<\/a> and we incorporated it in the sample\u00a0to make sure the user\u00a0grants\u00a0location access permission to\u00a0the app. This ensures that the app can access the device’s location in order to show nearby places of interest, and when the location access permission has not been granted, it will notify the user and request them to allow access.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631202,"id":631202,"title":"Permissions-5","filename":"Permissions-5.png","filesize":34740,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/permissions-5","alt":"Nearby sample - request device location permission","author":"7721","description":"","caption":"Nearby sample - request device location permission","name":"permissions-5","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:27","modified":"2019-10-09 18:51:40","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":895,"height":897,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","medium-width":260,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","medium_large-width":768,"medium_large-height":770,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","large-width":895,"large-height":897,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","1536x1536-width":895,"1536x1536-height":897,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","2048x2048-width":895,"2048x2048-height":897,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5-464x465.png","card_image-width":464,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Permissions-5.png","wide_image-width":895,"wide_image-height":897}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Additionally, since we are using online geocoding and routing services, we need to make sure that the device has an active internet connection for the app to function. Thus, we added a check for network access that will notify the user to turn on an internet connection in case the connection is lost or is not available.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":631192,"id":631192,"title":"Network-6","filename":"Network-6.png","filesize":34784,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/appstudio\/announcements\/introducing-the-nearby-sample-app\/network-6","alt":"Nearby sample - offline statement","author":"7721","description":"","caption":"Nearby sample - offline statement","name":"network-6","status":"inherit","uploaded_to":631042,"date":"2019-10-09 16:57:25","modified":"2019-10-09 18:51:48","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":895,"height":897,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","medium-width":260,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","medium_large-width":768,"medium_large-height":770,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","large-width":895,"large-height":897,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","1536x1536-width":895,"1536x1536-height":897,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","2048x2048-width":895,"2048x2048-height":897,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6-464x465.png","card_image-width":464,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/10\/Network-6.png","wide_image-width":895,"wide_image-height":897}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Technical Highlights:<\/h3>\n

This sample app is built with ArcGIS Runtime,<\/a> uses Google Material Design<\/a> for the user interface, and is powered by Esri’s world Geocoding<\/a> service to find places of interest such as restaurants, hotels, libraries, etc. If you are interested in the technical details and project structure of this sample app, please read this blog<\/a> from AppStudio GeoNet to learn more.<\/p>\n

 <\/p>\n

We would like to thank Tresor Cyubahiro, one of our amazing summer interns, who helped us with this sample app.\u00a0<\/em><\/p>\n

 <\/p>\n

 <\/p>\n"},{"acf_fc_layout":"content","content":"