Feature/ch115970/support new here api keys

[Mmoncadaisla]

Context

This PR aims to add support for new HERE API authentication method through the apikey param (as opposed to app_code and app_id) for Geocoding (serial and bulk) and Isolines Location Data Services, using the new HERE API versions when possible (serial geocoder and isolines services).

Changes have been performed following the HERE migration guides:

• https://developer.here.com/documentation/geocoding-search-api/migration_guide/index.html

• https://developer.here.com/documentation/routing-api/8.14.0/migration_guide/index.html

For further context please see the CH Story: https://app.clubhouse.io/cartoteam/story/115970/support-new-here-api-keys

NOTE: All the changes have been performed in the dataservices-api server side and should not affect the current behavior.

Main additions

• service_factory module to return the corresponding HERE service depending on the use_apikey parameter.
• HereMapsRoutingIsolineV8 isolines routing functionality for HERE v8 Routing service
• HereMapsGeocoderV7 serial geocoder class for HERE Maps GS7 Geocoding service
• HereMapsBulkGeocoderV7 Adapted version of the 6.2 service to be used with HERE apikeys.

  NOTE: This service would make use of the HERE 6.2Geocoder version and therefore different results may be returned depending on the number of records to be geocoded. This class falls back to the HereMapsGeocoderV7 serial geocoder if the number of addresses is below the MIN_BATCH_SEARCH value.

Usage

The new functionality can be set through the use_apikey (boolean) and apikey (string) parameters at the dataservices_db cdb_conf table level through the CDB_Conf_SetConf function as described in the README.

Relevant code changes

SQL

Changes in the corresponding SQL functions to make use of the service_factory functions.

• HERE geocode street point function
• HERE bulk geocoder function
• HERE isoline helper function

Python (cartodb_services package)

• service_factory module
• HERE v8 Routing Isolines
• HERE GS7 serial geocoder
• HERE 6.2 bulk geocoder adaption for apikey support
• polyline parsing adaption for HERE v8 Isolines tuple response
• Add flexpolyline dependency for v8 Routing Isolines response decoding

[shortcut-integration[bot]]

This pull request has been linked to Clubhouse Story #115970: Support new HERE api keys.

[Mmoncadaisla]

Thank you a lot for your help and suggestions @Shylpx!! just included these, could you please take a look when time? 🙂

[Mmoncadaisla]

@Jesus89 it seems that there are two tests failing which are (apparently) unrelated to this PR,

• dataservices-api (10): could be an error with a dependency nose not being found
• dataservices-api (12): seems to be an error related to a change in the Geocodio API response for a test address.

Should we go ahead and try to fix them as part of this PR? In that case, do you have any suggestions in order to handle the broken test related to the nose dependency?