Street Names per Postal Code

Available lang-locales: de (Germany) only

This service returns and/or sets STT (Speech-to-Text) hints for all street names in a postal code area (Germany only). It is particularly useful for an address dialog where the postal code is first inquired, allowing the STT to be primed for all valid streets in that area. This prevents potential issues with transcribing certain street names.

Service Configuration

Branches

• success: Indicates the service call was completed successfully.

Input

• zip: Enter the postal code/ZIP code to retrieve street names.

• stt: To set STT hints, input any non-empty value. This activates STT hints for street names.

• includeNumbers: Option to append numbers 1-19 to the STT hints, enhancing recognition accuracy.

Output

• streetNames: Returns a comma-separated list of street names for the specified area.

Note: If the 'stt' input is provided, the output will include a special speechToTextHints value, offering tailored STT support.

Technical configuration

• URL: https://parloaservices.azurewebsites.net/api/StreetNames?clientId=<CLIENT_ID>

• Header: x-functions-key: <AUTHCODE>

For authentication, ensure to replace <AUTHCODE> and <CLIENT_ID> with the credentials provided by your Parloa representative.

Dialog Usage

Add the service to your dialog as usual. A sample input set is shown below:

Example Inputs

zip

The service expects a 5-digit ZIP code, currently only from Germany.

For example:

Example Zip Code

10785

stt

This field acts as a boolean. Enter any value to activate it. When activated, an extra output field is provided by the service, containing all the street names belonging to the ZIP code organized as separate strings in an array. This output object is used by the NLU to better match the caller's input.

Example Zip Code

1

includeNumbers

This field acts as a boolean. Enter any value to activate it. When activated, a list of numbers from 1 to 19 will be added to the speechToTextHints, helping the NLU model account for street numbers given by the caller.

For example:

Example Zip Code

1

Result Examples

Simple Example

Basic request of street names:

Example Zip Code

10119

---

Output

streetNames

Ackerstraße,Almstadtstraße,Alte Schönhauser straße,Angermünder straße,Auguststraße,Brunnenstraße,Choriner straße,Christinenstraße,Fehrbelliner straße,Gipsdreieck,Gipsstraße,Gormannstraße,Griebenowstraße,Jacob-Teitel-Park,Joachimstraße,Kastanienallee,Kleine Auguststraße,Kleine Rosenthaler straße,Linienstraße,Lottumstraße,Max-Beer-straße,Mulackstraße,Prenzlauer Allee,Rosa-Luxemburg-straße,Rosenthaler Platz,Rosenthaler straße,Rückerstraße,Saarbrücker straße,Schendelgasse,Schendelpark,Schönhauser Allee,Schwedter straße,Steinstraße,Straßburger straße,Swinemünder straße,Templiner straße,Teutoburger Platz,Torstraße,Veteranenstraße,Volkspark am Weinberg,Weinbergsweg,Zehdenicker straße,Zionskirchplatz,Zionskirchstraße