Why use the Custom Location Extension?
Contents
1. G om etry AGMA CO rennen er eher 28 Create a New Layer uessssesssssnssensensnnnnnnnnnnonnnnnnonnnnnnnnnnnsnsunnnnnsnnnnsssnnnnsssensnensonnnsssnnnsssennnsssennnnn 29 Delete an Existing Gesmel seen 30 Chapter 3 Service Support 32 Custom Location Extension User Guide 3 gt Legal Notices Legal Notices 2014 HERE All rights reserved This material including documentation and any related computer programs is protected by copyright controlled by HERE All rights are reserved Copying including reproducing storing adapting or translating any or all of this material requires the prior written consent of HERE This material also contains confidential information which may not be disclosed to others without the prior written consent of HERE Trademark Acknowledgements HERE and Nokia are trademarks or registered trademarks of Nokia Corporation in the United States and other countries Other trade names are trademarks or registered trademarks of their owners Disclaimer This content is provided as is and without warranties of any kind either express or implied including but not limited to the implied warranties of merchantability fitness for a particular purpose satisfactory quality and non infringement Nokia does not warrant that the content is error free and Nokia does not warrant or make any representations regarding the quality correctness accuracy or reliability of the content You should therefore veri2. Service Support If you need assistance in using the administration website contact your HERE representative or Technical Customer Support via email at tcsplatform here com
3. 15 gt Using Custom Location Extension accept the confirmation for the system to remove a layer from the database When you delete a layer all the related items are deleted You need to reimport the data to restore the layer Figure 7 Layer Details Pop Up Window Layer details Layer Id 3 Name Coffee Shop Description This layer contains POls with type coffee sh delete Custom Search Index Administration The web platform for Custom Location Extension allows you to create and manage custom search indices A custom search index typically represents one or more fields from one or more layers Custom Location Extension User Guide 16 gt Using Custom Location Extension Create a Custom Search Index To create a new custom search index click on the Layers button in the main menu of the administration website and select Indexes Figure 8 Layers Screen Customers Locations Layers Geometries Imports Reports Statistics Help Layers Indexes Ad Do 2 indexes Create index On the Administrate indexes screen click on the Create index button to display a pop up window to add a new layer Administrate indexes E ETE Fill in a name application ID and description The name and description entries can only be 20 characters long Select the layers and fields to be indexed from the drop down boxes and click the Create button B Note The application ID app_id you enter here must be the same as that used when perf
4. Custom Location Extension User Guide Using Custom Location Extension The Import reports search results page appears Figure 18 Location Import Reports Search Results Locations Layers Geometries Imports Reports Statistics 26 Import reports from layerid 2014 05 01 184 User Guide Test VW to 2014 05 20 layerld type startDate endDate 184 CSV 20 05 2014 13 32 20 05 2014 13 32 184 CSV 20 05 2014 13 46 20 05 2014 13 46 status DONE Select a report to view details about the location import and to download the upload information Edit or Delete Locations To administrate custom locations select the Locations button in the administration website choose the layer to which they belong from the dropdown list and enter any relevant criteria in the search fields Click the Search button to display the relevant locations Figure 19 Administrate your locations Locations Layers Geometries Imports Reports Statistics Administrate your locations Search for in these fields layer namel v all v Search E Only marked as to review Edit a Location Create location Click on the location you wish to edit and modify information in the Location details pop up window You can modify information in the form fields or move the location on the map manually by moving the map marker Custom Location Extension User Guide 27 gt Using Custom Location Extension El Note There are two different
5. the import process The latitude of the location The longitude of the location Required Name of the location Alternate name of the location can be used to indicate the name in another language Alternate name of the location can be used to indicate the name in another language The latitude to which a user should be navigated for the location entrance The longitude to which a user should be navigated for the location entrance Phone number for the location Postal code for the location State in which the location exists Name of the street on which the location exists Web address of the location must be a valid address beginning with hre9 hetps3 0r ftps 7 Click the send button to begin importing The Custom Location Extension adds your new locations as specified and displays a progress bar while the import is in progress CSV import layer 184 User Guide Test Layer Application Id vibeJOXTnWOtAbZS9Y3F Choose file Delimiter enclosure Browse location_im port_UserGuideTestLayer csv og ga a The CSV import finished page appears when the import is complete Custom Location Extension User Guide 21 gt Using Custom Location Extension CSV import layer 184 User Guide Test Layer Y Application Id vibeJOXTNW9tADZS9Y3F Y Choose file Delimiter enclosure Browse location_import_UserGuideTestLayer csv The import finished Please use this button to view the details Cli
6. BA Wo AUa ISN 184 User Guide Test Layer Y W Greenleaf Are Loyola W Lunt Ave Park Morse aay MOISE Ih WoMorse Ave W Morse Ave MORKA NAWTEG 2012 Terms of Use A coordinate latitude longitude 42 0 43 N 87 39 41 W route coordinate latitude longitude y 42 0 46 N 87 39 43 W New location saved create Click the create button to save your new location Searching for Existing Locations If there are already locations in this layer you can search and display them by clicking the Search button You can refine the search criteria by selecting a field in the database Custom Location Extension User Guide 25 gt Using Custom Location Extension Locations Layers Geometries Imports Reports Statistics Administrate your locations Create location Search for in these fields namel v Search Import namel CustLocid name2 name3 city postalCode country E Only marked as to review description custom Attribute Generating Location Import Reports You can generate reports listing all attempted location imports within a specified timeframe by clicking on the Imports button in the main menu Figure 17 Location Imports Reports Screen Locations Layers Geometries Imports Reports Statistics Help Import reports from layerid 2014 05 01 all v to 2014 05 20 On the Imports screen choose the timeframe and the layer for your report and click the search button
7. Custom Location Extension User Guide Version 1 7 0 Custom Location Extension User Guide 2 gt Contents Contents Lepal N tIces nenne EO een 3 Document InTOrMauon eer een nern 4 Chapter 1 Overview 5 What is the Custom Location Extension 6 Why use the Custom Location Extension ccccccssccssesssesscssscsscessccseessecsecesecesecssecseccssceseesseessesseenaees 6 Chapter 2 Using Custom Location Extension 7 PC UIA Lredentlials ae a E AEN ETEVA OGEN AOAN 8 Login to the Custom Location Extension Administration Website ussesseesesseesesseeensensenenennennn 8 USER Aamine T aO a E E N se 9 Creste a New US Een er EA TOE E E E EE EAEE en 9 Edit or Disable an Existing User unsssessssseeseesensnennennennennnnnnonnnennennennnnnnennensnnnnennensanennnnenn 12 layer Administration ee 13 Create a New Lay ae R E T E E E 13 Edit or Delete an Existing Layer een 14 Custom Search Index Administration eeeeesesseeseeseesensensensenensensensenennnnnonsonnnnensnnnnnnonnnnsnennnnnnnnennennenn 15 Create a L stom Search NOS ee 16 Edit or Delete an Existing Custom Search Index uecesseesessesseessenseeneenennennnnnnensnnnnnenennennnn 16 Location FACING ON eu een einen ee 18 Create OF Upload MOC AHO NS easnsrssn e a N 18 Generating Location Import RepofrtS ssessesssesssesseeseesseesseeseessesssesseessesssessseseesresseeseesseessesso 25 Editor Delete LOCATORS nee een 26
8. Customers Locations Layers Geometries Imports Reports Statistics Help Indexes Custom Location Extension User Guide 14 gt Using Custom Location Extension On the Administrate layers screen click onthe Create layer button to display apop up window to add a new layer Administrate layers Create layer layerld name description 3 Nokia L amp C Sites EMEA Layer used for Examples 6 Hotspots DE only for testing Test Layer with T Mobile Hotspots DE 23 Speed Traps speed trap test layer 36 Misc Locations Only for testing 40 Fegro rewe test layer test layer 61 Advocard test layer Advocard test layer staging DB 65 File Imports For testing update deployments Lo sun u ial nn nenne ne Fill in the new layer name and description and click the Create button The layer is now available in the Administrate layers menu and can be now be assigned to a user of this customer To change the layer name and description click the layer in the Administrate layers menu Edit or Delete an Existing Layer To edit an existing layer access the administration website From the home screen click on the Layers button and select Layers Click directly on the layer that you wish to edit to display the Layer details pop up window In this window make changes as needed and click save to modify the layer or delete to delete it The website displays a confirmation prompt for layer deletion You must Custom Location Extension User Guide
9. ann E 6 Hotspots DE only for testing Password musterm nn4NoKklaA E 23 Speed Traps E mail 36 Misc Locations max mustermann nokia com E IM an Fanrn frewe tect lawer create Once you have finished defining the user settings click the Create button to save this user Edit or Disable an Existing User To edit an existing user access the administration website From the home screen click on the Users button Click directly on the user that you wish to edit to display the User Details pop up window In Custom Location Extension User Guide 13 gt Using Custom Location Extension this window make changes as needed and click save to modify the user or Disable account to inactivate that user s account Figure 5 User Details Pop Up Window User details Id 184 Salutation Mr Display both coordinates in location details First name Max Last name Mustermann User name m mustermann Password musterm nn4NOKIA E mail max mustermann nokia com Disable account Layer Administration The web platform for Custom Location Extension allows you to create and manage location layers Layers typically represent a location type and by associating custom locations with a layer you can enable or disable their display in an application Create a New Layer To create a new layer click on the Layers button in the main menu of the administration website and select Layers Figure 6 Layers Screen
10. asthaus Phone number Fax number E mail address Gasthaus koch t online de Web URL www gasthaus pension koch de Icon URL delete Qe ey Geometry Administration The web platform for Custom Location Extension allows you to import and manage geometries from zipped shapefiles E Note Custom Location Extension does not currently support the importation of point based shapefiles Custom Location Extension User Guide 29 Using Custom Location Extension Create a New Layer To import a set of geometries click on the Geometries button in the main menu of the administration website Figure 21 Geometries Screen Locations Layers Imports Reports Statistics Help Administrate your geometries all v Import On the Administrate your geometries screen click Import to import your shapefile Custom Location Extension expects the imported file to be in zip format and to comply with the esri standard any shape such as PolyLine Polygon and MultiPolygon is accepted as a point in the system Shapefile import layer 184 User Guide Test Layer Y Choose file geometry_import zip Click the sena button to begin importing The Custom Location Extension adds your new geometries as specified and displays a progress bar while the import is in progress Shapefile import layer 184 User Guide Test Layer ha Choose file Browse_ geometry_import zip The import is in progress You can close this window n
11. ck the details button to see additional information about the import and to download the upload information Create Locations To create a new location using the administration website click the Create location button Figure 13 Create Locations Button Locations Geometries Reports Administrate your locations Create location Search for in these fields layer namel v all v Only marked as to review Custom Location Extension User Guide 22 gt Using Custom Location Extension On the Create location pop up window enter the basic address and custom attributes of the new location as shown below Figure 14 Basic Attributes Birchwood Ave Map view A Fargo Awe rvis E yepp tS e W chase Ave 5 Leone ah and BA W Teuhy Ave 2Ay wea h th 7 W Estes Anne W Greenleaf Ave Loyola W Lunt Ave iT Park Morse aa Ma AUS yl WoMorse Ave W Morse Ave NOKIA 11 ANAT EO 2012 Terms of Use AN coordinate latitude longitude 42 0 43 N 87 39 41 W route coordinate latitude longitude P 4 0 AG N 87 39 43 W Create location Customer Location Id 1734 Namel Picnic Area Namez Names Description This is a picnic area at Loyola Park in Chica Phone number Fax number E mail address Web URL Icon URL Layer 184 User Guide Test Layer Y create Custom Location Extension User Guide 23 Using Custom Location Ex
12. ckbox is disabled Custom Location Extension only uses the display coordinates Figure 3 Set Permission Roles for New User User create Salutation Mr First name Y Role Read Max Last name Fil Role Write Mustermann q User name E Role Customer Admin 7 m mustermann Password musterm nn4NorlaA E mail max mustermann nokia com create Inthe User roles area enable any of the following permission roles by selecting the appropriate checkbox Read Enables the user to view locations and their attributes in the administration website This option is enabled by default Write Allows the user to write change and delete locations and their attributes via the web interface Customer Admin Grants the user administrative rights for a specific customer This allows the user to view create change and disable both locations and users for that customer The first user account created for a specific customer should get this permission role Custom Location Extension User Guide 12 Using Custom Location Extension Finally specify which layers the user can see or edit If you do not see any layers in this menu you must create a layer for this customer first To create a layer see Layer Administration on page 13 Figure 4 Set Layer Permissions for aNew User User create Salutation Mr First name Max 1 All layers Last name Mustermann F 3 Nokia L amp C Sites EMEA User name m musterm
13. coordinate markers available one for the display coordinates which are bound to the address of the location another marker for the route coordinates which represent those you can navigate to by car Figure 20 Location Details Window ocation details Gasthaus Customer Location Id 1234323 Mamel Gasthaus Name con Hotel other Ba Names 4 Hotel other Description Gasthaus NOKIA Phone number NAWVTEO 201F Terms of Use coordinate latitude longitude DO 50 34 14 N 11 7 16 E Fax number route coordinate latitude longitude v E mail address 9 50 3A 14 N I1 7 16 E Gasthaus koch t online de Web URL www gasthaus pension koch de Icon URL delete After you have finished modifying the location click the save button to confirm your changes Delete a Location You can delete a location by clicking the delete button on the Location details window You must accept the confirmation prompt to remove the location Custom Location Extension User Guide 28 Using Custom Location Extension Map view F Se 4 Pur a fr Sira F et F p e a cS p N gy NOK LA s NAVTEQ 2017 Terms of Use coordinate latitude longitude 50 34 14 N 11 7 16 E route coordinate latitude longitude P 50 34 14 N 11 7 16 E Location details Gasthaus Customer Location Id 1234323 Mamel Gasthaus Name Hotel other Names Hotel other Description G
14. fy any information contained in the content before acting on it To the furthest extent permitted by law under no circumstances including without limitation Nokia s negligence shall Nokia be liable for any damages including without limitation direct special indirect punitive consequential exemplary and or incidental damages that result from the use or application of this content even if Nokia or an authorized representative has been advised of the possibility of such damages Custom Location Extension User Guide gt Document Information Document Information Product Name Version Document Name Id Status Date Custom Location Extension Version 1 7 0 Custom Location Extension User Guide 006518d 1414410616 FINAL 2014 Oct 27 11 51 GMT Custom Location Extension User Guide 5 gt Overview Chapter 1 Overview Topics This user guide introduces the Custom Location Extension e What is the Custom Location administrator web interface explains essential concepts and Extension describes the common use cases e Why use the Custom Location Extension Custom Location Extension User Guide 6 gt Overview What is the Custom Location Extension HERE Custom Location Extension is a service that stores and retrieves custom locations Upload locations as CSV files or ESRI standard compliant shapes via an administration website or as XML files via HTTP POST requests to the RESTful API Re
15. layer Y 7 select field delete Custom Location Extension User Guide 18 Using Custom Location Extension Location Administration The administration website allows you to create and manage custom locations POIs on the Locations page Locations can be imported created and managed Create or Upload Locations To import custom locations from a CSV file or to create new locations in the adminstration website click the Locations button in the administration website Figure 10 Location Administration Locations Layers Geometries Imports Reports Statistics Administrate your locations Create location Search for in these fields layer namel Yv all v E Only marked as to review Import Locations To import locations from a CSV file click the Import button Figure 11 Import Button Locations Geometries Imports Reports Statistics Administrate your locations Create location Search for in these fields layer namel v all v E Only marked as to review Custom Location Extension User Guide 19 gt Using Custom Location Extension Inthe CSV import pop up window select the layer into which you want to upload the locations your CSV file and your correct Application ID app_id You can also edit the delimiter and enclosure types for your file Figure 12 CSV Import Window CSV import layer 154 User Guide Test Layer Application Id vibeJOXTNWS9tAbDZ59Y3F Choose file De
16. limiter enclosure _Browse_ No file selected Click the send button to upload your file In the CSV import column assignment pop up window assign the columns in your CSV file to the appropriate columns in Custom Location Extension The following list describes the available columns CITY Required The city where the location exists COUNTRY ISO 3166 Required The country where the location exists specified by 3 digit country code For example use code DEU for Germany COUNTY The county where the location exists CUST LOCATION ID Required A unique ID specifying the location in your system or database DESCRIPTION A description of the location DISPLAY LAT Y The latitude at which to display the location marker bound to the location address DISPLAY LON X The longitude at which to display the location marker bound to the location address EMAIL ADDRESS Email address associated with the location FAX NUMBER Fax number associated with the location HOUSE NUMBER Address number of the location Custom Location Extension User Guide 20 gt Using Custom Location Extension ICON URL ignore this field LATITUDE Y LONGITUDE X NAME1 NAME2 NAME3 NAVIGATION LAT Y NAVIGATION LON X PHONE NUMBER POSTALCODE STATE STREET NAME WEB URL URL of the logo file for the location must be a valid address beginning with heep 7 hetps 0r Ep 7 This indicates that the column will be ignored during
17. ntials users layers locations shapes and custom search indices e Login to the Custom Location Extension Administration Website e User Administration e Layer Administration e Custom Search Index Administration e Location Administration e Geometry Administration Custom Location Extension User Guide 8 gt Using Custom Location Extension Acquiring Credentials All users of HERE APIs must obtain authentication and authorization credentials and provide them as values for the parameters app_id and app_code The credentials are assigned per application To access the administration website you need a username and a password The administration website has two addresses e Production environment address https customlocation here com admin e Staging environment address https stg customlocation nokia com admin To obtain the credentials for an application or for the adminstration website contact your HERE representative or HERE Technical Customer Support as described in Service Support on page 32 Login to the Custom Location Extension Administration Website To begin using the administration website open a web browser and navigate to either the production or the staging URL as shown below Production environment login page meere a n eona acon adm n Staging environment login page https 7 stg customlocation nokia com admin In the signin prompt enter your user credentials and click the Login button Custom Location E
18. orming a search from an application and it must be one that is associated with your user account The custom search index is now available in the Administrate indexes menu To change the index ID application ID name and description click an index in the Administrate indexes menu When you create a custom search index the Custom Location Extension may take some time to finish generating the required index If a request to a new custom searh index produces an error message saying that the index is not accessible the index generation may still be on going Edit or Delete an Existing Custom Search Index To edit an existing custom search index access the administration website From the home screen click on the Layers button and select Indexes Click directly on the index that you wish to edit to display the Index details pop up window In this window make changes as needed and click save Custom Location Extension User Guide 17 gt Using Custom Location Extension to modify the layer or delete to delete it The website displays a confirmation prompt for index deletion You must accept the confirmation for the system to remove an index from the database Figure 9 Index Details Pop Up Window Index details Index Id 51 Application Id vibeJOXTnW9tAbZS9Y3F Name indexDemo2 Description index Demo Index fields 3 Nokia LEC Sites EMESF namel ka 575 AA POI 505 Y name ka 575 AA POI 505 Y street select
19. ow or wait until it is finished The Shapefile import finished page appears when the import is complete Custom Location Extension User Guide 30 gt Using Custom Location Extension Shapefile import layer 184 User Guide Test Layer hal Choose file Browse_ geometry_import zip The import finished Please use this button to view the details Click the details button to see additional information about the import and to download the upload information The geometry geometries are now available in Custom Location Extension Delete an Existing Geometry To delete an existing geometry access the administration website From the home screen click on the Geometry button Click directly on the geometry that you wish to delete to display the Geometry details pop up window Custom Location Extension User Guide 31 gt Using Custom Location Extension ring sa Jj paraenzuys Bai ho eat i jf wpa esham 4 mA SN Walth m t in ers rE i wis g5 ut Geometry details pgc2007 basic attributes Geometry Id 1589359 Name pgc2007 custom attributes 30 ur Bl 3 God alming 20 4gkia Terms of Use Ho Er ir delete O Click delete to delete it The website displays a confirmation prompt for layer deletion You must accept the confirmation for the system to remove a layer from the database Custom Location Extension User Guide 32 gt Service Support Chapter 3
20. tension When you have completed the address information details click the geocode button to display the location on the map You can drag and drop the location markers to edit the precise location of either the display or the navigation coordinates Figure 15 Geocode Button Birchwaod Ave Map wiew C n t ti reale location A Fargo Ave rvis uri a i ae a z 5 3 Country p W Chase Ave Y7 United States F z eone en ra State W Touhy Ave X n W Estes Ave k County z Cook Gi a W Greenleat Ave City al d 5 Loyola Chicago We LuntAve Park Morse l Postal code W Marse Ave W Morse Ave NOKIA k Street name ELNANTEQ 2012 Terms of Use 4 coordinate latitude longitude 4 0 43 N 87 39 41 W route coordinate latitude longitude F 42 0 46 N 87 39 43 W geocode House number Layer 184 User Guide Test Layer W create Custom Location Extension User Guide 24 Using Custom Location Extension Inthe custom attributes area choose the layer to which the location belongs You can also click the add new attribute button to add new attribute and value pairs to provide additional information about the location You can add up to 50 custom attributes per location Figure 16 Create Button Birchwood Ave Map view Create location wis E p W chase Ave Leone m Touhy Ave A add new attribute Oy W Estes Awe h dia Layer
21. trieve locations by making HTTP GET requests to the RESTful API This document provides information about the administration website To learn more about how to retrieve and upload locations using the API see the Custom Location Extension Developer s Guide Why use the Custom Location Extension Custom Location Extension provides solutions for the following high level use cases e Store custom sets of locations and polygons for use with other HERE APIs e Perform a proximity search for custom points of interest and polygons around a specified location e Retrieve a set of custom points of interest POIs and or polygons within a specified bounding box e Find all custom locations and polygons within an isoline route result e Find all custom locations and or polygons within a specified radius of a defined route e Search custom indices generated from multiple fields from one or more layers This document describes the functionality available in the administration website including the ability to e create a new user or search for an existing user e import and manage locations e manage layers in the system e import geometries also known as shapes or polygons for maps e create and manage custom search indices Custom Location Extension User Guide 7 gt Using Custom Location Extension Chapter 2 Using Custom Location Extension Topics The following sections describe how to create and manage new e Acquiring Crede
22. xtension User Guide 9 Using Custom Location Extension Sign in please Username Password User Administration The administration website allows you to create manage search and disable custom location data users Create a New User To create a new user click on the Users button in the main menu of the administration website Figure 1 Create a New User Locations Layers Geometries Imports Reports Statistics Help Administrate customers Search for in these fields applid v On the Administrate users screen click on the Create user button to display a pop up window with the user details amp Custom Location Extension User Guide 10 gt Using Custom Location Extension Inthe User create pop up window fill in the basic information for the new user At a minimum you must include a username and a password that contains at least 8 characters and one each of uppercase lower and special characters Figure 2 User Create Pop Up Window User create Salutation Mr T Display both coordinates in location details First name Max Last name Mustermann User name m mustermann Password musterm nn4NOKIA E mail max mustermann nokia com create Custom Location Extension User Guide 11 gt Using Custom Location Extension Inthe User settings area check Display both coordinates in location details to show display and route coordinates used for navigation to the location for the user When this che
Download Pdf Manuals
Related Search