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 |