Zum Hauptinhalt springen
Deutsch
|
English

MAPQUEST_APP_KEY - Detailed description

FM-Portal

IC0000
FM-Portal

Overview

Parameter:MAPQUEST_APP_KEY
Category: OpenStreetMaps
Default value: leer (String.Empty)
Product: eTASK.Other (OpenStreetMaps)

What does this parameter do?

This parameter contains the access key (App Key) for the MapQuest geocoding service. It enables the conversion of entered addresses into geographic coordinates (longitude and latitude), which are then used for map display in the eTASK FM portal. Without this key, addresses cannot be automatically positioned on the map.

What is this parameter used for?

  • Address search and geocoding: Conversion of entered addresses into coordinates

  • Building placement on maps: Automatic positioning of buildings based on the address

  • Coordinate determination: Finds longitude and latitude for entered locations

  • Address validation: Verification and completion of address entries

  • Interactive map features: Enables address search in map views

Technical Details (for Administrators)

Format: Alphanumeric access key (App Key)
Default value: leer (String.Empty)

Important notes:

  • The App Key is provided by MapQuest after registration at https://developer.mapquest.com/

  • Pricing model: The MapQuest geocoding service is free for a certain number of requests per month

  • If the free usage limit is exceeded, the service becomes subject to a fee

  • Without a valid App Key, a message will appear indicating that the address search is unavailable

  • This parameter works closely with MAPBOX_ACCESS_TOKEN

Interaction with other parameters:

  • MAPBOX_ACCESS_TOKEN: Required for map display; both parameters must be configured for full map functionality

  • MAPBOX_MAP_ID / MAPBOX_STYLE: Determine the visual appearance of the map after successful geocoding

When should you change this value?

Set the value (enter the App Key) if:

  • You want to enable address search and automatic coordinate determination

  • Users need to find buildings on the map by entering an address

  • You want to use full OpenStreetMap integration

  • A new App Key has been issued after registering with MapQuest

  • The existing key has expired or needs to be renewed

Leave this field blank (do not set) if:

  • The address search and geocoding functions are not required

  • Coordinates are entered manually

  • You have decided not to use the MapQuest service

  • You want to avoid costs for the MapQuest service

Important Notes

  1. Registration required
    To obtain a valid App Key, you must first register with MapQuest at https://developer.mapquest.com/. Registration is free.

  2. Monitor usage costs
    The service is free only up to a certain number of requests per month. Monitor usage in your MapQuest dashboard to avoid unexpected costs. For larger installations with frequent address searches, the limit can be reached quickly.

  3. No address lookup without a key
    If this parameter is empty or invalid, users will see a message stating that address lookup is unavailable and that configuration must be performed by an administrator. Coordinates must then be entered manually.

  4. Full configuration required
    For full map functionality, you need both MAPQUEST_APP_KEY (for geocoding) and MAPBOX_ACCESS_TOKEN (for map rendering). Without both parameters, map functionality is limited.

  5. Key security:
    Treat the app key as confidential and do not share it publicly. In the MapQuest dashboard, you can revoke and regenerate keys as needed.

Security

Does changing this parameter affect security?

Yes, configuring this parameter has minor but relevant security implications.

Positive aspects:

  • The key is project-specific and can be easily revoked and replaced if compromised

  • MapQuest provides mechanisms for usage control and limitation

  • The transmitted address data is generally not highly sensitive

Note:

  • The app key should not be stored or shared in publicly accessible areas

  • If misused, a compromised key could result in unwanted costs if the free usage limit is exceeded

  • Using external services means that address data is transmitted to MapQuest

  • Verify that the transmission of location data to MapQuest is consistent with your privacy policy

Data protection assessment:

  • When used, address data and possibly IP addresses are transmitted to the MapQuest service

  • If necessary, inform your users about the use of external geocoding services

  • Review MapQuest’s privacy policy for GDPR compliance

  • Consider whether alternative geocoding services with stricter privacy policies are available

Practical example

Initial situation: A facility management company has already configured MAPBOX_ACCESS_TOKEN and maps are displayed. However, employees must manually determine and enter the coordinates for each new building, which is time-consuming and error-prone. Address entry in the building form does not work automatically—a message appears stating that the geocoding function is not configured.

Configuration: The administrator registers with MapQuest (https://developer.mapquest.com/), receives an App Key, and enters it into the system configuration:

After the change:

  • Employees can simply enter the address in the building form

  • The system automatically determines the geographic coordinates

  • The building is immediately positioned correctly on the map

  • The error rate for location entry drops significantly

  • The time saved is approximately 2–3 minutes per new building

Result: The address search works reliably. Employees appreciate the significantly simplified building creation process. Data quality improves, as manual coordinate errors no longer occur. Monthly usage is approximately 400 geocoding requests, remaining within the free quota.

Recommended setting

For standard installations:Registrierten MapQuest App Key eintragen

Reason:

  • Address search and automatic coordinate determination are valuable features

  • Significant time savings when creating building layouts

  • Reduces input errors with coordinates

  • Costs are manageable for standard installations thanks to the free usage limit

  • Registration with MapQuest is simple and free

  • In combination with MAPBOX_ACCESS_TOKEN, you get a complete mapping solution

For very small installations or if the geocoding feature is not needed, the parameter can be left blank. Note, however, that users will then have to enter coordinates manually and the address search will not be available.

War dieser Artikel hilfreich?