Rückgabwerte

Container-Elemente

Element Beschreibung
GeoResult Wenn die Ortsinformation nicht eindeutig ist, wird eine Liste mit den in
Frage kommenden Orten zurückgeliefert. Die Suche wird mit der ersten
Adresse in der Liste durchgeführt, die dann auch in der Ergebnisliste
angezeigt wird.
Paging Informationen zur aktuellen Seite
AddressResult Die Liste der Adressen, die zu den Suchekriterien gefunden werden.
Wenn über einen Bezeichner (ID) gesucht wird, erhalten Sie detailierte
Informationen, andernfalls lediglich Basisdaten. Eine genauere Beschreibung finden Sie hier.
RelatedBranches Falls verwandte Branchen vorliegen, werde sie in dieser Liste
zurückgegeben
SearchData Parameter, die für die Suche verwendet wurden
AddressItemsCopyright Copyright-Informationen zu den zurückgelieferten Adressen
Memoitem Öffnungszeiten der zurückgelieferten Adressen, falls angegeben

Öffnungszeiten: Werte

Bei den Werten der Öffnungszeiten, der nachfolgend beschriebenen Masken, werden die folgenden beiden Formate unterstützt:

Typ 1: mit Trennzeichen ":"

Beispiel:

1|08:00|20:00|09:00|20:00|10:00|15:00  

Typ 2: ohne Trennzeichen

Beispiel:

1|0800|2000|0900|2000|1000|1500  

In diesen Fällen kann das gewünschte Trennzeichen für die Öffnungszeiten gewählt werden. Wir empfehlen dies an der dritten Stelle von rechts zu ergänzen.

Öffnungszeiten: Masken

In manchen Fällen liegen die Öffnungszeiten strukturiert vor, dann gibt die „Mask“ die Maske oder Struktur vor, um den Inhalt zu interpretieren.

Typ 0 / Freitext (Enum: NONE)

Ist im Feld kein Typ angegeben, so wird es als Freitext interpretiert.

Typ 1 (Enum: MASK_1)

Die Öffnungszeiten werden von Montag bis Freitag, Samstag und Sonntag hinterlegt.

Beispiel:

1|08:00|20:00|09:00|20:00|10:00|15:00  

Output:

  • Montag bis Freitag von [1] bis [2]
  • Samstag von [3] bis [4]
  • Sonntag von [5] bis [6]

Typ 2 (Enum: MASK_2)

Die Öffnungszeiten werden von jedem Wochentag einzeln hinterlegt.

Beispiel:

2|06:00|22:00|06:00|21:00|06:00|22:00|08:00|20:00|06:00|22:00|09:00|22:
00|11:00|16:00
Output:

  • Montag von [1] bis [2]
  • ...
  • Freitag von [9] bis [10]
  • Samstag von [11] bis [12]
  • Sonntag von [13] bis [14]

Typ 3 (Enum: MASK_3)

Gleiche Maske wie Typ 2, nur dass das Feld für einen langen Samstag hinzu kommt. Zu beachten ist, dass im folgendem Beispiel die letzten beiden Felder leer gelassen sind und damit am Sonntag geschlossen ist.

Beispiel:

3|10.00|20.00|10.00|20.00|10.00|20.00|10.00|20.00|10.00|20.00|12.00|18.
00|10.00|20.00||
Output:

  • Montag von [1] bis [2]
  • ...
  • Samstag von [11] bis [12]
  • Langer Samstag von [13] bis [14]
  • Sonntag geschlossen

Typ 4 (Enum: MASK_4)

Die vierte Maske beinhaltet für jeden Wochentag Öffnungszeiten sowohl für den Vormittag als
auch für den Nachmittag.
Eine langer Samstag kann hier nicht angegeben werden.

Beispiel:

4|08:00|12:00|13:00|18:00|08:00|12:00|13:00|18:00|08:00|12:00|13:00|18:
00|08:00|12:00|13:00|18:00|08:00|12:00|13:00|18:00|08:00|12:00||||||
Output:

  • Montag Vormittag von [1] bis [2]
  • Montag Nachmittag von [3] bis [4]
  • ...
  • Samstag Vormittag von [21] bis [22]
  • Samstag Nachmittag von [23] bis [24]
  • Sonntag geschlossen

Typ 5 (Enum: MASK_5)

Die fünfte Maske stellt eine Ausnahme dar. Sie beinhaltet eine beliebig lange Liste. Die
Elemente werden durch Pipes getrennt.

Beispiel:

Die einzelnen Listenelemente haben die Form:
[Tag 2-Stellig]#[von]#[bis](#[Ausnahme Datum])
Beispiel:
Mo#0900#2100#2021-06-14
Oder nur:
Di#0800#2000#
Vollständiges Beispiel:
5|Di#0800#2000#|Mi#0830#2000#|Fr#0800#1100#|Fr#1500#2100#
Output:

  • Dienstag von 08:00 bis 20:00
  • Mittwoch von 08:30 bis 20:00
  • Freitag von 08:00 bis 11:00
  • Freitag von 15:00 bis 21:00

Info: Das Ausnahmedatum stellt eine Sonderöffnungszeit an einem festgelegtem Datum dar, welche unabhängig von der für den Wochentag bestimmte Öffnungszeit ist.

XML


<AddressSearchResult>
 <GeoResult>
 <GeoItem>
 <Country>String</Country>
 […]
 </GeoItem>
 <GeoItem>
 […]
 </GeoResult>
 <Paging>
 <Page>Unsigned Integer</Page>
 <MaxPage>Unsigned Integer</MaxPage>
 <Count>Unsigned Integer</Count>
 </Paging>
 <AddressResult>
 <AddressItem>
 […]
 </AddressItem>
 </AddressResult>
 <RelatedBranches>
 […]
 </RelatedBranches>
 <SearchData>
 […]
 </SearchData>
 <AddressItemsCopyright>
 […]
 </AddressItemsCopyright>
</AddressSearchResult>

Informationen über die Eingabeparameter der Umkreissuche finden Sie in der Parameterübersicht.