Bitte beachten Sie, dass bei der direkten Bearbeitung der Maps Marker Pro-Datenbank über die API Vorsicht geboten ist, um Datenverlust zu vermeiden. Alle Anrufe sind sofort und können nicht rückgängig gemacht werden.
Bitte beachten Sie auch, dass unser Support keine detaillierten Fragen zur benutzerdefinierten Entwicklung auf der Grundlage dieser API abdeckt.
Anwendungsbereich
Um die DB-API zu verwenden, müssen wir zuerst die Klasse instanziieren:
$db = new MMP\DB();
Maps geben Objekte mit den folgenden Eigenschaften zurück:
id: ID name: Name settings: An object containing the map settings (JSON encoded) filters: An object containing the map filters (JSON encoded) created_by_id: The ID of the user who created the map created_on: The date and time when the map was created updated_by_id: The ID of the user who last updated the map updated_on: The date and time when the map was last updated markers: The number of markers that are assigned to this map (if requested)
Marker geben Objekte mit den folgenden Eigenschaften zurück:
id: ID name: Name address: Address lat: Latitude lng: Longitude zoom: Zoom icon: Icon filename popup: Popup contents link: URL to be opened instead of showing a popup created_by_id: The ID of the user who created the marker created_on: The date and time when the marker was created updated_by_id: The ID of the user who last updated the marker updated_on: The date and time when the marker was last updated maps: Array of map IDs that the marker is assigned to
Beispiele
Holen Sie sich die Karte mit der ID 1, ändern Sie den Namen, die Breite und die Höhe und speichern Sie die Änderungen
$map = $db->get_map(1); $map->name = 'Car dealerships'; $settings = json_decode($map->settings); $settings->width = 640; $settings->height = 480; $map->settings = json_encode($settings); $db->update_map($map, 1);
Holen Sie sich die Markierung mit ID 1, ändern Sie den Namen, das Symbol und das Popup und speichern Sie die Änderungen
$marker = $db->get_marker(1); $marker->name = 'Dealership 1'; $marker->icon = 'car.png'; $marker->popup = '<a href="https://example.com">Dealership 1 website</a>'; $db->update_marker($marker, 1);
Methodenreferenz
create_tables ()
Erstellt die Datenbanktabellen
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
Es wird kein Wert zurückgegeben
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_tables ()
Löscht die Datenbanktabellen
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
Es wird kein Wert zurückgegeben
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
reset_tables ()
Setzt die Datenbanktabellen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
Es wird kein Wert zurückgegeben
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
count_maps ($ Filter = array ())
Gibt die Gesamtzahl der Karten zurück
Akzeptiert optional eine Liste von Filtern
Parameter
- $ Filter
- (Array) (optional) Liste der Filter
Rückgabewerte
(int) Gesamtzahl der Karten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_map ($ Id, $ count = falsch)
Gibt die Karte für die angegebene ID zurück
Parameter
- $ Id
- (int) Karten-ID
- $ count
- (bool) (optional) Gibt an, ob die zugewiesenen Marker gezählt werden sollen
Rückgabewerte
(Objekt | null) Objekt zuordnen oder null, wenn kein Ergebnis gefunden wird
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_maps ($ ids, $ count = falsch)
Gibt die Karten für die angegebenen IDs zurück
Parameter
- $ ids
- (Array | String) Liste oder CSV der Karten-IDs
- $ count
- (bool) (optional) Gibt an, ob die zugewiesenen Marker gezählt werden sollen
Rückgabewerte
(Array) Liste der Kartenobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_all_maps ($ count = falsch, $ Filter = array ())
Gibt alle Karten zurück
Akzeptiert optional eine Liste von Filtern
Parameter
- $ count
- (bool) (optional) Gibt an, ob die zugewiesenen Marker gezählt werden sollen
- $ Filter
- (Array) (optional) Liste der Filter
Rückgabewerte
(Array) Liste der Kartenobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_map_shortcodes ($ Id)
Gibt alle Beiträge zurück, die einen Shortcode für die angegebene Karten-ID verwenden
Parameter
- $ Id
- (int) Karten-ID
Rückgabewerte
(Array) Liste der Beiträge
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
add_map ($ Data, $ Id = 0)
Fügt eine Karte hinzu
Parameter
- $ Data
- (Objekt) Zu schreibende Kartendaten
- $ Id
- (int) (optional) ID für die neue Karte
Rückgabewerte
(int | bool) Map ID oder false, wenn die Map nicht hinzugefügt werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
add_maps ($ Data)
Fügt mehrere Karten hinzu
Parameter
- $ Data
- (Array) Liste der zu schreibenden Kartendaten
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Karten nicht hinzugefügt werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
update_map ($ Data, $ Id)
Aktualisiert eine Karte
Parameter
- $ Data
- (Objekt) Zu schreibende Kartendaten
- $ Id
- (int) ID der zu aktualisierenden Karte
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Karte nicht aktualisiert werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
update_maps ($ Data, $ ids)
Aktualisiert mehrere Karten
Parameter
- $ Data
- (Objekt) Zu schreibende Kartendaten
- $ ids
- (Array | String) Liste oder CSV der Karten-IDs
Rückgabewerte
(int) Anzahl der betroffenen Zeilen
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_map ($ Id)
Löscht eine Karte und ihre Beziehungen
Parameter
- $ Id
- (int) ID der zu löschenden Karte
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Karte nicht gelöscht werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_maps ($ ids)
Löscht mehrere Karten und ihre Beziehungen
Parameter
- $ ids
- (Array | String) Liste oder CSV der Karten-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Karten nicht gelöscht werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
count_markers ($ Filter = array ())
Gibt die Gesamtzahl der Marker zurück
Akzeptiert optional eine Liste von Filtern
Parameter
- $ Filter
- (Array) (optional) Liste der Filter
Rückgabewerte
(int) Gesamtzahl der Marker
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
count_map_markers ($ Id)
Gibt die Gesamtzahl der Markierungen für die angegebene Karten-ID zurück
Parameter
- $ Id
- (int) Karten-ID
Rückgabewerte
(int) Gesamtzahl der Markierungen für die angegebene Karten-ID
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_marker ($ Id)
Gibt den Marker für die angegebene ID zurück
Parameter
- $ Id
- (int) Marker ID
Rückgabewerte
(Objekt | null) Markierungsobjekt oder null, wenn kein Ergebnis gefunden wird
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_markers ($ ids)
Gibt die Markierungen für die angegebenen IDs zurück
Parameter
- $ ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(Array) Liste der Markerobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_all_markers ($ Filter = array ())
Gibt alle Marker zurück
Akzeptiert optional eine Liste von Filtern
Parameter
- $ Filter
- (Array) (optional) Liste der Filter
Rückgabewerte
(Array) Liste der Markerobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_map_markers ($ Id)
Gibt die Markierungen für die angegebene Karten-ID zurück
Parameter
- $ Id
- (int) Karten-ID
Rückgabewerte
(Array) Liste der Markerobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_maps_markers ($ ids)
Gibt die Markierungen für die angegebenen Karten-IDs zurück
Parameter
- $ ids
- (int) Karten-IDs
Rückgabewerte
(Array) Liste der Markerobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
add_marker ($ Data, $ Id = 0)
Fügt einen Marker hinzu
Parameter
- $ Data
- (Objekt) Zu schreibende Markierungsdaten
- $ Id
- (int) (optional) ID für den neuen Marker
Rückgabewerte
(int | bool) Marker-ID oder false, wenn der Marker nicht hinzugefügt werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
add_markers ($ Data)
Fügt mehrere Marker hinzu
Parameter
- $ Data
- (Array) Liste der zu schreibenden Markierungsdaten
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht hinzugefügt werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
update_marker ($ Data, $ Id)
Aktualisiert einen Marker
Parameter
- $ Data
- (Objekt) Zu schreibende Markierungsdaten
- $ Id
- (int) ID des zu aktualisierenden Markers
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierung nicht aktualisiert werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
update_markers ($ Data, $ ids)
Aktualisiert mehrere Marker
Parameter
- $ Data
- (Objekt) Zu schreibende Markierungsdaten
- $ ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht aktualisiert werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
assign_marker ($ map_id, $ marker_id)
Weist einer Karte eine Markierung zu
Parameter
- $ map_id
- (int) Karten-ID
- $ marker_id
- (int) Marker ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn der Marker nicht zugewiesen werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
assign_markers ($ map_id, $ marker_ids)
Weist einer Karte mehrere Markierungen zu
Parameter
- $ map_id
- (int) Karten-ID
- $ marker_ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht zugewiesen werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
assign_maps_marker ($ map_ids, $ marker_id)
Weist mehreren Karten eine Markierung zu
Parameter
- $ map_ids
- (Array | String) Liste oder CSV der Karten-IDs
- $ marker_id
- (int) Marker ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn der Marker nicht zugewiesen werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
assign_maps_markers ($ map_ids, $ marker_ids)
Weist mehreren Karten mehrere Markierungen zu
Parameter
- $ map_ids
- (Array | String) Liste oder CSV der Karten-IDs
- $ marker_ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht zugewiesen werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
assign_assoc ($ assoc)
Weist Markierungen aus einer assoziativen Liste zu
Parameter
- $ assoc
- (Array) Assoziative Liste der Marker-ID => Karten-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht zugewiesen werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.9 | Eingeführt |
unassign_marker ($ map_id, $ marker_id)
Hebt die Zuordnung einer Markierung von einer Karte auf
Parameter
- $ map_id
- (int) Karten-ID
- $ marker_id
- (int) Marker ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierung nicht aufgehoben werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
unassign_markers ($ map_id, $ marker_ids)
Hebt die Zuordnung mehrerer Markierungen von einer Karte auf
Parameter
- $ map_id
- (int) Karten-ID
- $ marker_ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht aufgehoben werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
unassign_maps_marker ($ map_ids, $ marker_id)
Hebt die Zuordnung eines Markers von mehreren Karten auf
Parameter
- $ map_ids
- (Array | String) Liste oder CSV der Karten-IDs
- $ marker_id
- (int) Marker ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierung nicht aufgehoben werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
unassign_all_markers ($ map_id)
Hebt die Zuordnung aller Markierungen von einer Karte auf
Parameter
- $ map_id
- (int) Karten-ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht aufgehoben werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
unassign_all_maps ($ marker_id)
Hebt die Zuordnung eines Markers von allen Karten auf
Parameter
- $ marker_id
- (int) Marker ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierung nicht aufgehoben werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.14 | Eingeführt |
delete_marker ($ Id)
Löscht einen Marker und seine Beziehungen
Parameter
- $ Id
- (int) ID des zu löschenden Markers
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn der Marker nicht gelöscht werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_markers ($ ids)
Löscht mehrere Marker und ihre Beziehungen
Parameter
- $ ids
- (Array | String) Liste oder CSV der Marker-IDs
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Markierungen nicht gelöscht werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_layer ($ Id)
Gibt die Ebene für die angegebene ID zurück
Parameter
- $ Id
- (int) Schicht-ID
Rückgabewerte
(Objekt | null) Ebenenobjekt oder null, wenn kein Ergebnis gefunden wird
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_all_layers ()
Gibt alle Ebenen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Ebenenobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_all_basemaps ()
Gibt alle Grundkarten zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Ebenenobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
get_all_overlays ()
Gibt alle Überlagerungen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Ebenenobjekte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
add_layer ($ Data, $ Id = 0)
Fügt eine Ebene hinzu
Parameter
- $ Data
- (Objekt) Zu schreibende Schichtdaten
- $ Id
- (int) (optional) ID für die neue Ebene
Rückgabewerte
(int | bool) Layer-ID oder false, wenn der Layer nicht hinzugefügt werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
update_layer ($ Data, $ Id)
Aktualisiert eine Ebene
Parameter
- $ Data
- (Objekt) Zu schreibende Schichtdaten
- $ Id
- (int) ID der zu aktualisierenden Schicht
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Ebene nicht aktualisiert werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_layer ($ Id)
Löscht eine Ebene
Parameter
- $ Id
- (int) Schicht-ID
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Ebene nicht gelöscht werden konnte
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
delete_orphaned_rels ()
Löscht verwaiste Beziehungen
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(int | bool) Anzahl der betroffenen Zeilen oder false, wenn die Waisen nicht gelöscht werden konnten
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.7 | Eingeführt |
build_marker ($ Data, $ geojson = falsch)
Erstellt ein gültiges Markierungsobjekt
Parameter
- $ Data
- (Array) Liste der Markierungsdaten
- $ geojson
- (bool) (optional) Gibt an, ob die Daten im GeoJSON-Format vorliegen
Rückgabewerte
(Array) Markierungsobjekt
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.9 | Eingeführt |
sanitize_ids ($ ids, $ csv = falsch)
Bereinigt ein Array oder eine durch Kommas getrennte Liste von IDs
Parameter
- $ ids
- (Array | String) Liste oder CSV von IDs
- $ csv
- (bool) (optional) Gibt an, ob die bereinigten IDs als CSV zurückgegeben werden sollen
Rückgabewerte
(Array | String) Liste oder CSV bereinigter IDs
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
prepare_layers ()
Gibt die Bereinigungsregeln für Layertabellen für Vorbereitungsanweisungen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Desinfektionsregeln (Spalte => Regel)
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
prepare_maps ()
Gibt die Bereinigungsregeln für die Kartentabelle für Vorbereitungsanweisungen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Desinfektionsregeln (Spalte => Regel)
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
prepare_markers ()
Gibt die Bereinigungsregeln für die Markertabelle für Vorbereitungsanweisungen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Desinfektionsregeln (Spalte => Regel)
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
prepare_rels ()
Gibt die Bereinigungsregeln für Beziehungstabellen für Vorbereitungsanweisungen zurück
Parameter
Diese Methode hat keine Parameter
Rückgabewerte
(Array) Liste der Desinfektionsregeln (Spalte => Regel)
Änderungsprotokoll
| Einschränkungen | Beschreibung |
|---|---|
| 4.0 | Eingeführt |
