Baza danych API

Contents [show]

Należy pamiętać, że należy zachować ostrożność podczas manipulowania bazą danych Maps Marker Pro bezpośrednio za pośrednictwem interfejsu API, aby uniknąć utraty danych. Wszystkie połączenia są natychmiastowe i nie można ich cofnąć.

Należy również pamiętać, że nasze wsparcie nie obejmuje szczegółowych pytań dotyczących niestandardowego programowania w oparciu o ten interfejs API.

Stosowanie

Aby użyć interfejsu API DB, musimy najpierw utworzyć instancję klasy:

$db = new MMP\DB();

Mapy zwracają obiekty o następujących właściwościach:

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)

Markery zwracają obiekty o następujących właściwościach:

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

Przykłady

Uzyskaj mapę o identyfikatorze 1, zmień nazwę, szerokość i wysokość i zapisz zmiany

$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);

Zdobądź znacznik o identyfikatorze 1, zmień nazwę, ikonę i wyskakujące okienko i zapisz zmiany

$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);

Odniesienie do metody

create_tables ()

Tworzy tabele bazy danych


parametry

Ta metoda nie ma parametrów


Zwróć wartości

Żadna wartość nie jest zwracana


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_tables ()

Usuwa tabele bazy danych


parametry

Ta metoda nie ma parametrów


Zwróć wartości

Żadna wartość nie jest zwracana


Lista zmian

Wersja Opis
4.0 wprowadzony

reset_tables ()

Resetuje tabele bazy danych


parametry

Ta metoda nie ma parametrów


Zwróć wartości

Żadna wartość nie jest zwracana


Lista zmian

Wersja Opis
4.0 wprowadzony

count_maps (filtry $ = szyk())

Zwraca całkowitą liczbę map
Opcjonalnie przyjmuje listę filtrów


parametry

filtry $
(tablica) (opcjonalnie) Lista filtrów

Zwróć wartości

(int) Całkowita liczba map


Lista zmian

Wersja Opis
4.0 wprowadzony

get_map ($ id, $ liczyć = fałszywy)

Zwraca mapę dla podanego identyfikatora


parametry

$ id
(int) Identyfikator mapy
$ liczyć
(bool) (opcjonalnie) Czy liczyć przypisane znaczniki

Zwróć wartości

(obiekt | null) Odwzoruj obiekt lub null, jeśli nie znaleziono żadnego wyniku


Lista zmian

Wersja Opis
4.0 wprowadzony

get_maps ($ ids, $ liczyć = fałszywy)

Zwraca mapy dla podanych identyfikatorów


parametry

$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów map
$ liczyć
(bool) (opcjonalnie) Czy liczyć przypisane znaczniki

Zwróć wartości

(tablica) Lista obiektów mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

get_all_maps ($ liczyć = fałszywy, filtry $ = szyk())

Zwraca wszystkie mapy
Opcjonalnie przyjmuje listę filtrów


parametry

$ liczyć
(bool) (opcjonalnie) Czy liczyć przypisane znaczniki
filtry $
(tablica) (opcjonalnie) Lista filtrów

Zwróć wartości

(tablica) Lista obiektów mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

get_map_shortcodes ($ id)

Zwraca wszystkie posty, które używają krótkiego kodu dla podanego identyfikatora mapy


parametry

$ id
(int) Identyfikator mapy

Zwróć wartości

(tablica) Lista postów


Lista zmian

Wersja Opis
4.0 wprowadzony

add_map ($ dane, $ id = 0)

Dodaje mapę


parametry

$ dane
(obiekt) Dane mapy do zapisania
$ id
(int) (opcjonalnie) Identyfikator nowej mapy

Zwróć wartości

(int | bool) Identyfikator mapy lub fałsz, jeśli nie można dodać mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

add_maps ($ dane)

Dodaje wiele map


parametry

$ dane
(tablica) Lista danych mapy do zapisania

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można dodać map


Lista zmian

Wersja Opis
4.0 wprowadzony

update_map ($ dane, $ id)

Aktualizuje mapę


parametry

$ dane
(obiekt) Dane mapy do zapisania
$ id
(int) Identyfikator mapy do aktualizacji

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można zaktualizować mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

update_maps ($ dane, $ ids)

Aktualizuje wiele map


parametry

$ dane
(obiekt) Dane mapy do zapisania
$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów map

Zwróć wartości

(int) Liczba dotkniętych wierszy


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_map ($ id)

Usuwa mapę i jej relacje


parametry

$ id
(int) Identyfikator mapy do usunięcia

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można usunąć mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_maps ($ ids)

Usuwa wiele map i ich relacje


parametry

$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów map

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli map nie można usunąć


Lista zmian

Wersja Opis
4.0 wprowadzony

markery_liczników (filtry $ = szyk())

Zwraca całkowitą liczbę znaczników
Opcjonalnie przyjmuje listę filtrów


parametry

filtry $
(tablica) (opcjonalnie) Lista filtrów

Zwróć wartości

(int) Całkowita liczba markerów


Lista zmian

Wersja Opis
4.0 wprowadzony

count_map_markers ($ id)

Zwraca całkowitą liczbę znaczników dla podanego identyfikatora mapy


parametry

$ id
(int) Identyfikator mapy

Zwróć wartości

(int) Całkowita liczba markerów dla danego identyfikatora mapy


Lista zmian

Wersja Opis
4.0 wprowadzony

get_marker ($ id)

Zwraca znacznik dla podanego identyfikatora


parametry

$ id
(int) Identyfikator markera

Zwróć wartości

(obiekt | null) Obiekt znacznika lub null, jeśli nie znaleziono żadnego wyniku


Lista zmian

Wersja Opis
4.0 wprowadzony

get_markers ($ ids)

Zwraca znaczniki dla podanych identyfikatorów


parametry

$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(tablica) Lista obiektów znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

get_all_markers (filtry $ = szyk())

Zwraca wszystkie znaczniki
Opcjonalnie przyjmuje listę filtrów


parametry

filtry $
(tablica) (opcjonalnie) Lista filtrów

Zwróć wartości

(tablica) Lista obiektów znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

get_map_markers ($ id)

Zwraca znaczniki dla podanego identyfikatora mapy


parametry

$ id
(int) Identyfikator mapy

Zwróć wartości

(tablica) Lista obiektów znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

get_maps_markers ($ ids)

Zwraca znaczniki dla podanych identyfikatorów map


parametry

$ ids
(int) Identyfikatory map

Zwróć wartości

(tablica) Lista obiektów znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

add_marker ($ dane, $ id = 0)

Dodaje znacznik


parametry

$ dane
(obiekt) Dane znacznika do zapisania
$ id
(int) (opcjonalnie) Identyfikator nowego znacznika

Zwróć wartości

(int | bool) Identyfikator znacznika lub fałsz, jeśli nie można dodać znacznika


Lista zmian

Wersja Opis
4.0 wprowadzony

add_markers ($ dane)

Dodaje wiele markerów


parametry

$ dane
(tablica) Lista danych znaczników do zapisania

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można dodać znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

update_marker ($ dane, $ id)

Aktualizuje znacznik


parametry

$ dane
(obiekt) Dane znacznika do zapisania
$ id
(int) Identyfikator znacznika do aktualizacji

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można zaktualizować znacznika


Lista zmian

Wersja Opis
4.0 wprowadzony

update_markers ($ dane, $ ids)

Aktualizuje wiele znaczników


parametry

$ dane
(obiekt) Dane znacznika do zapisania
$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można zaktualizować znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

przypisać znacznik ($ map_id, $ marker_id)

Przypisuje znacznik do mapy


parametry

$ map_id
(int) Identyfikator mapy
$ marker_id
(int) Identyfikator markera

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można przypisać znacznika


Lista zmian

Wersja Opis
4.0 wprowadzony

przypisać znaczniki ($ map_id, $ marker_ids)

Przypisuje wiele znaczników do mapy


parametry

$ map_id
(int) Identyfikator mapy
$ marker_ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można przypisać znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

assign_maps_marker ($ map_ids, $ marker_id)

Przypisuje znacznik do wielu map


parametry

$ map_ids
(tablica | ciąg) Lista lub CSV identyfikatorów map
$ marker_id
(int) Identyfikator markera

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można przypisać znacznika


Lista zmian

Wersja Opis
4.0 wprowadzony

assign_maps_markers ($ map_ids, $ marker_ids)

Przypisuje wiele znaczników do wielu map


parametry

$ map_ids
(tablica | ciąg) Lista lub CSV identyfikatorów map
$ marker_ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można przypisać znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

assign_assoc ($ assoc)

Przypisuje markery z listy asocjacyjnej


parametry

$ assoc
(tablica) Powiązana lista znaczników ID => identyfikatory map

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli nie można przypisać znaczników


Lista zmian

Wersja Opis
4.9 wprowadzony

unassign_marker ($ map_id, $ marker_id)

Cofa przypisanie znacznika z mapy


parametry

$ map_id
(int) Identyfikator mapy
$ marker_id
(int) Identyfikator markera

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli znacznik nie może być nieprzypisany


Lista zmian

Wersja Opis
4.0 wprowadzony

unassign_markers ($ map_id, $ marker_ids)

Cofa wiele znaczników z mapy


parametry

$ map_id
(int) Identyfikator mapy
$ marker_ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można przypisać znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

unassign_maps_marker ($ map_ids, $ marker_id)

Cofa przypisanie znacznika z wielu map


parametry

$ map_ids
(tablica | ciąg) Lista lub CSV identyfikatorów map
$ marker_id
(int) Identyfikator markera

Zwróć wartości

(int | bool) Liczba dotkniętych wierszy lub fałsz, jeśli znacznik nie może być nieprzypisany


Lista zmian

Wersja Opis
4.0 wprowadzony

unassign_all_markers ($ map_id)

Cofa wszystkie znaczniki z mapy


parametry

$ map_id
(int) Identyfikator mapy

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można przypisać znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_marker ($ id)

Usuwa znacznik i jego relacje


parametry

$ id
(int) Identyfikator znacznika do usunięcia

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można usunąć znacznika


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_markers ($ ids)

Usuwa wiele znaczników i ich relacje


parametry

$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów znaczników

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można usunąć znaczników


Lista zmian

Wersja Opis
4.0 wprowadzony

get_layer ($ id)

Zwraca warstwę dla podanego identyfikatora


parametry

$ id
(int) ID warstwy

Zwróć wartości

(obiekt | null) Obiekt warstwy lub null, jeśli nie znaleziono żadnego wyniku


Lista zmian

Wersja Opis
4.0 wprowadzony

get_all_layers ()

Zwraca wszystkie warstwy


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista obiektów warstwowych


Lista zmian

Wersja Opis
4.0 wprowadzony

get_all_basemaps ()

Zwraca wszystkie mapy bazowe


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista obiektów warstwowych


Lista zmian

Wersja Opis
4.0 wprowadzony

get_all_overlays ()

Zwraca wszystkie nakładki


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista obiektów warstwowych


Lista zmian

Wersja Opis
4.0 wprowadzony

add_layer ($ dane, $ id = 0)

Dodaje warstwę


parametry

$ dane
(obiekt) Dane warstwy do zapisania
$ id
(int) (opcjonalnie) identyfikator nowej warstwy

Zwróć wartości

(int | bool) ID warstwy lub fałsz, jeśli nie można dodać warstwy


Lista zmian

Wersja Opis
4.0 wprowadzony

update_layer ($ dane, $ id)

Aktualizuje warstwę


parametry

$ dane
(obiekt) Dane warstwy do zapisania
$ id
(int) Identyfikator warstwy do aktualizacji

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można zaktualizować warstwy


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_layer ($ id)

Usuwa warstwę


parametry

$ id
(int) ID warstwy

Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można usunąć warstwy


Lista zmian

Wersja Opis
4.0 wprowadzony

delete_orphaned_rels ()

Usuwa osierocone relacje


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(int | bool) Liczba zmienionych wierszy lub fałsz, jeśli nie można usunąć sierot


Lista zmian

Wersja Opis
4.7 wprowadzony

build_marker ($ dane, $ geojson = fałszywy)

Tworzy poprawny obiekt znacznika


parametry

$ dane
(tablica) Lista danych znaczników
$ geojson
(bool) (opcjonalnie) Czy dane są w formacie GeoJSON

Zwróć wartości

(tablica) Obiekt znacznika


Lista zmian

Wersja Opis
4.9 wprowadzony

sanitize_ids ($ ids, $ csv = fałszywy)

Czyści listę identyfikatorów oddzieloną tablicą lub przecinkami


parametry

$ ids
(tablica | ciąg) Lista lub CSV identyfikatorów
$ csv
(bool) (opcjonalnie) Czy zwracać zdezynfekowane identyfikatory jako CSV

Zwróć wartości

(tablica | ciąg) Lista lub CSV oczyszczonych identyfikatorów


Lista zmian

Wersja Opis
4.0 wprowadzony

prepar_layers ()

Zwraca reguły czyszczenia tabeli warstw dla instrukcji przygotowania


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista reguł odkażania (kolumna => reguła)


Lista zmian

Wersja Opis
4.0 wprowadzony

prepar_maps ()

Zwraca reguły czyszczenia tabeli map dla przygotowywania instrukcji


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista reguł odkażania (kolumna => reguła)


Lista zmian

Wersja Opis
4.0 wprowadzony

prepar_markers ()

Zwraca reguły czyszczenia tabeli znaczników do przygotowywania instrukcji


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista reguł odkażania (kolumna => reguła)


Lista zmian

Wersja Opis
4.0 wprowadzony

prepar_rels ()

Zwraca reguły czyszczenia tabeli relacji dla instrukcji przygotowania


parametry

Ta metoda nie ma parametrów


Zwróć wartości

(tablica) Lista reguł odkażania (kolumna => reguła)


Lista zmian

Wersja Opis
4.0 wprowadzony
3
2
11932
Oceń to odniesienie
en English
X