ARCHIWUM - Web API (tylko wersja 3.1.1 lub nowsza)

Ważna uwaga: interfejs WebAPI został usunięty wraz z Maps Marker Pro v4.0.

Maps Marker Pro oferuje zintegrowany interfejs API, który umożliwia zarządzanie znacznikami i warstwami poprzez wysoce konfigurowalny interfejs API sieci Web, który obsługuje żądania GET i POST, JSON i XML jako formaty i został opracowany z naciskiem na bezpieczeństwo. Jeśli stworzyłeś fajną aplikację opartą na MapsMarker API daj nam znać i dodamy to do naszego gabloty! wskaźnik

Punkt końcowy

  • Darmowa wersja: https://www.twoja-domena.com/wp-content/plugins/leaflet-maps-marker/leaflet-api.php
  • Wersja Pro (<= wersja 2.9): https://www.twoja-domena.com/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php
  • Wersja Pro (> = wersja 3.0): https://www.twoja-domena.com/maps/webapi/

Zdecydowanie zaleca się używanie protokołu https tylko w celu uzyskania dostępu do interfejsu API sieci Web, ponieważ w przeciwnym razie tajny token może zostać przechwycony przez osoby trzecie podczas przesyłania go w postaci zwykłego tekstu za pośrednictwem protokołu http!

powrót do indeksu

Uwierzytelnianie

Wszystkie żądania muszą zostać uwierzytelnione przy użyciu wygasającego podpisu. Jest to podobne do podejścia zastosowanego przez Amazon w celu zapewnienia dostępu do ich interfejsu API pamięci masowej S3. Po uwierzytelnieniu można wykonać wszystkie aktywowane działania API. Oprócz środków bezpieczeństwa egzekwowanych przez API, zdecydowanie zaleca się implementację protokołu SSL dla strony WordPress (poza zakresem tego API).

Włączanie interfejsu API i ustawianie publicznego i prywatnego klucza API

Aby korzystać z interfejsu API, musisz najpierw ustawić status interfejsu API na włączony, przechodząc do ustawień API Ustawienia / Różne / MapsMarker: obsługa interfejsu API W następnym kroku musisz ustawić publiczny i prywatny klucz API: klucz prywatny

WAŻNE: Zachowaj klucz prywatny w tajemnicy. Nie wolno go w żaden sposób udostępniać i nie może być zawarte w żadnych linkach ani przekazywane przez przewód. Służy wyłącznie do obliczania podpisu dla każdego żądania API. Jako następny krok nie zapomnij zapisać ustawień. powrót do indeksu

Wymagane parametry żądania uwierzytelnienia

Każde żądanie musi zawierać co najmniej 3 następujące parametry zapytania;

  • api_key - publiczny klucz API zdefiniowany na stronie ustawień / misc / MapsMarker ustawienia API - np. „1234”
  • wygasa - data ważności żądania wyrażona jako znacznik czasu UNIX w sekundach, np. 1369749344
  • podpis - Skrypt HMAC-SHA64 zakodowany w url, base1 łańcucha rozdzielonego dwukropkami, o następującej strukturze:
    {api_key}: {wygasa}
    np. 1234: 1369749344
    Podpis tego żądania przy użyciu klucza prywatnego „abcd” to XlWau4wu3UBPUZbBeCXuyDxzg7g% 3D

Kompletna prośba przykładowa: http://twojadomena.com/wp-content/plugins/leaflet-maps-marker/pro/leaflet-api.php?key=1234&signature=XlWau4wu3UBPUZbBeCXuyDxzg7g%3D&expires=1369749344 powrót do indeksu

Przykładowy kod PHP do generowania podpisów

<?php function calculate_signature($string, $private_key) { $hash = hash_hmac("sha1", $string, $private_key, true); $sig = rawurlencode(base64_encode($hash)); return $sig; } $api_key = "1234"; $private_key = "abcd"; $expires = strtotime("+60 mins"); $string_to_sign = sprintf("%s:%s", $api_key, $expires); $sig = calculate_signature($string_to_sign, $private_key); var_dump($sig); ?> powrót do indeksu

Przykładowy kod JavaScript do generowania podpisów

<script src="https://crypto-js.googlecode.com/svn/tags/3.1.2/build/rollups/hmac-sha1.js"></script> <script src="https://crypto-js.googlecode.com/svn/tags/3.1.2/build/components/enc-base64-min.js"></script> <script type="text/javascript"> function CalculateSig(stringToSign, privateKey){ var hash = CryptoJS.HmacSHA1(stringToSign, privateKey); var base64 = hash.toString(CryptoJS.enc.Base64); return encodeURIComponent(base64); } var d = new Date, expiration = 3600 // 1 hour, unixtime = parseInt(d.getTime() / 1000), future_unixtime = unixtime + expiration, publicKey = "1234", privateKey = "abcd", stringToSign = publicKey + ":" + future_unixtime; sig = CalculateSig(stringToSign, privateKey); console.log(sig); </script> powrót do indeksu

Przykładowy kod C # do generowania podpisów

using System; using System.Web; using System.Security.Cryptography; using System.Text; namespace MapsMarkerPro { public class Sample { public static GenerateSignature() { string publicKey = "1234"; string privateKey = "abcd"; string expires = Security.UtcTimestamp(new TimeSpan(0,1,0)); string stringToSign = string.Format("{0}:{1}", publicKey, expires); var sig = Security.Sign(stringToSign, privateKey); Console.WriteLine(sig); } } public class Security { public static string UrlEncodeTo64(byte[] bytesToEncode) { string returnValue = System.Convert.ToBase64String(bytesToEncode); return HttpUtility.UrlEncode(returnValue); } public static string Sign(string value, string key) { using (var hmac = new HMACSHA1(Encoding.ASCII.GetBytes(key))) { return UrlEncodeTo64(hmac.ComputeHash(Encoding.ASCII.GetBytes(value))); } } public static int UtcTimestamp( TimeSpan timeSpanToAdd) { TimeSpan ts = (DateTime.UtcNow.Add(timeSpanToAdd) - new DateTime(1970,1,1,0,0,0)); int expires_int = (int) ts.TotalSeconds; return expires_int; } } } powrót do indeksu

API URL Generator i API URL Tester

Najbezpieczniejszym sposobem uwierzytelnienia jest użycie jednego z powyższych przykładów kodu w celu zbudowania podpisu dynamicznego, który wygasa wkrótce po wykonaniu żądania (zalecany jest czas wygaśnięcia 1 minuty). Jeśli nie jest to dla Ciebie opcja, możesz przejść do Narzędzia / Generator URL API i wygenerować podpis, który jest ważny przez wybrany okres czasu: generator api-url Dostępne terminy ważności: 1 minuta, godzina, dzień, tydzień, miesiąc, rok, 5 lat, 10 lat, 100 lat. Należy pamiętać, że wygenerowanie podpisu API, który jest ważny przez dłuższy czas, może obniżyć ogólne bezpieczeństwo API, ponieważ ktoś, kto pozna ten podpis, może wykonać dowolne działania API! W sekcji narzędzi znajduje się również tester API URL, który pozwala sprawdzić ważność podpisu: api-url-tester powrót do indeksu

Dostępne metody żądania

  • GET
  • POST

powrót do indeksu

Dostępne parametry akcji

  • widok
  • Dodaj
  • aktualizacja (tylko wersja pro)
  • usuń (tylko wersja pro)
  • szukaj (tylko wersja pro)

powrót do indeksu

Dostępne parametry typu

  • znacznik
  • warstwa

powrót do indeksu

Parametry globalne (dla wszystkich akcji API)

ParametrWymagany?Typ danychDomyślna wartośćUwagi
wersjafakultatywnyliczba całkowita1
kluczwymaganyciągPubliczny klucz API, należy ustawić poprzez Ustawienia / Różne / MapsMarker API
podpiswymaganyciągwięcej informacji znajduje się w rozdziale dotyczącym uwierzytelniania
wygasawymaganyciągwięcej informacji znajduje się w rozdziale dotyczącym uwierzytelniania
formatfakultatywnyciągjsonjson lub xml - domyślnie można ustawić za pomocą API Settings / MapsMarker
remap_ *fakultatywnyciągNULLpozwala na mapowanie danych wyjściowych identyfikatorów pól (np. remap_lon = długość geograficzna) -> <długość geograficzna>...</ długość geograficzna>
oddzwonićfakultatywnyciągjsonpNazwa funkcji wywołania zwrotnego JSONP - wartość domyślną można ustawić za pomocą interfejsu API ustawień / MapsMarker
powrót do indeksu

Dostępne parametry znacznika typu

ParametrWymagany?Typ danychDomyślna wartośćObsługiwane w działaniachUwagi
idwymaganyliczba całkowitaustawiane automatycznie po dodaniu nowego znacznikawidok
Dodaj
aktualizacja
usunąć
szukanie
nazwa markifakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
geokodfakultatywnyciągNULLDodaj
aktualizacja
wartość jest geokodowana za pomocą interfejsu API Miejsc Google i zastępuje parametr lat, lon i adres
Mapa bazyfakultatywnypredefiniowane identyfikatory mapy bazowej - patrz uwagidomyślna mapa bazowa dla nowego znacznika (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
osm_mapnik, mapquest_osm, mapquest_aerial, googleLayer_roadmap, googleLayer_satellite, googleLayer_hybrid, googleLayer_terrain, bingaerial, bingaerialwithlabels, bingroad, ogdwien_basemap, custom__bapbox, custom__bapbox, custom__bap
warstwafakultatywnyliczba całkowitadomyślna warstwa dla nowego znacznika (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
latfakultatywnyunosić siędomyślna lokalizacja nowego znacznika (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
lonfakultatywnyunosić siędomyślna lokalizacja nowego znacznika (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
ikonafakultatywnyciąg (np. bus.png)NULLwidok
Dodaj
aktualizacja
szukanie
jeśli NULL, zostanie użyta domyślna ikona. Proszę po prostu użyć nazwy pliku ikony podanej w przykładzie. Wszystkie ikony dostępne w katalogu ikon (zwykle / wp-content / uploads / leaflet-maps-marker-icons, jeśli nie zmieniłeś ich w Ustawieniach / domyślnych mapach / Domyślne wartości ikon znaczników) są dostępne do użycia.
wyskakujący tekstfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
zoomfakultatywnyliczba całkowitadomyślne powiększenie nowego znacznika (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
openpopupfakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
szerokość mapyfakultatywnyliczba całkowitadomyślna szerokość mapy dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
mapwidthunitfakultatywnyciągwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wysokość mapyfakultatywnyliczba całkowitadomyślna wysokość mapy dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
płytafakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
stworzone przezfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
utworzonyfakultatywnydata (Ymd H: i: s)NULLwidok
Dodaj
aktualizacja
szukanie
aktualizowany przezfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
zaktualizowanofakultatywnydata (Ymd H: i: s)data („Ymd H: i: s)widok
Dodaj
aktualizacja
szukanie
skrzynka kontrolnafakultatywnyliczba całkowitawartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
możliwe wartości: 0,1,2
overlays_customfakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom2fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom3fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom4fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
WMSfakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms2fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms3fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms4fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms5fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms6fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms7fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms8fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms9fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms10fakultatywnybooleanwartość domyślna dla nowych znaczników (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
kml_timestampfakultatywnydata (Ymd H: i: s)NULLwidok
Dodaj
aktualizacja
szukanie
adresfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
gpx_urlfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
od wersji 1.2p
gpx_panelfakultatywnyboolean0widok
Dodaj
aktualizacja
szukanie
od wersji 1.2p
powrót do indeksu

Dostępne parametry dla warstwy tekstowej

ParametrWymagany?Typ danychDomyślna wartośćUtrzymany
w działaniach
Uwagi
idwymaganyliczba całkowitaustawiane automatycznie po dodaniu nowego znacznikawidok
Dodaj
aktualizacja
usunąć
szukanie
geokodfakultatywnyciągNULLDodaj
aktualizacja
wartość jest geokodowana za pomocą interfejsu API Miejsc Google i zastępuje parametr lat, lon i adres
NazwafakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
Mapa bazyfakultatywnypredefiniowane wartościdomyślna mapa bazowa dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
osm_mapnik, mapquest_osm, mapquest_aerial, googleLayer_roadmap, googleLayer_satellite, googleLayer_hybrid, googleLayer_terrain, bingaerial, bingaerialwithlabels, bingroad, ogdwien_basemap, custom__bapbox, custom__bapbox, custom__bap
layerzoomfakultatywnyliczba całkowitadomyślne powiększenie nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
mapwidthunitfakultatywnyciągwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
szerokość mapyfakultatywnyliczba całkowitadomyślna szerokość mapy dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wysokość mapyfakultatywnyliczba całkowitadomyślna wysokość mapy dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
płytafakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
layerviewlatfakultatywnyunosić siędomyślna łata dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
layerviewlonfakultatywnyunosić siędomyślny lon dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
stworzone przezfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
utworzonyfakultatywnydata (Ymd H: i: s)NULLwidok
Dodaj
aktualizacja
szukanie
aktualizowany przezfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
zaktualizowanofakultatywnydata (Ymd H: i: s)data („Ymd H: i: s)widok
Dodaj
aktualizacja
szukanie
skrzynka kontrolnafakultatywnyliczba całkowitawartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
możliwe wartości: 0, 1, 2
overlays_customfakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom2fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom3fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
overlays_custom4fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
WMSfakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms2fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms3fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms4fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms5fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms6fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms7fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms8fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms9fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
wms10fakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
znaczniki listfakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
opcja pokazania listy markerów pod mapami warstw
multi_layer_mapfakultatywnyboolean0widok
Dodaj
aktualizacja
szukanie
multi_layer_map_listfakultatywnyciąg (identyfikatory warstw oddzielone przecinkami lub wszystkie)NULLwidok
Dodaj
aktualizacja
szukanie
np. 1,2,3,4 lub wszystkie
adresfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
zostanie zastąpiony, jeśli użyty zostanie parametr geokod!
delete_markersfakultatywnyprawda fałszfałszywyusunąćw przypadku użycia w akcji usuwania usuwane są również przypisane znaczniki
klastrowaniefakultatywnybooleanwartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
szukanie
dostępne tylko w wersji pro
gpx_urlfakultatywnyciągNULLwidok
Dodaj
aktualizacja
szukanie
od wersji 1.2p
gpx_panelfakultatywnyboolean0widok
Dodaj
aktualizacja
szukanie
od wersji 1.2p
mlm_filterfakultatywnyliczba całkowitawartość domyślna dla nowej warstwy (patrz ustawienia)widok
Dodaj
aktualizacja
mlm_filter_detailsfakultatywnyCiąg JSONNULLwidok
Dodaj
aktualizacja
powrót do indeksu

Specjalne parametry dla akcji wyszukiwania

ParametrWymagany?Typ danychUwagi
klucz wyszukiwaniawymaganyciągDozwolone klawisze wyszukiwania: id, nazwa markera, mapa bazowa, warstwa, lat, lon, ikona, popup, tekst, powiększenie, openpopup, szerokość mapy, mapwidthunit, wysokość mapy, panel, utworzone przez, utworzone przez, zaktualizowane, zaktualizowane, skrzynka kontrolna, nakładki_standardowe, nakładki_standardowe2, nakładki niestandardowe3, nakładki_standardowe4, wms , wms2, wms3, wms4, wms5, wms6, wms7, wms8, wms9, wms10, kml_timestamp, adres, gpx_url, gpx_panel, nazwa, layerzoom, layerviewlat, layerviewlon, markery, mult_layer_map, multi_layer_map_list
wartość wyszukiwaniazależyciąg lub liczba całkowitageneralnie wymagane, ale opcjonalne w przypadku użycia klucza wyszukiwania utworzonego na, zaktualizowanym lub obwiedni
Data, odzależyciąg (Ymd H: i: s)generalnie opcjonalne, ale wymagane w przypadku używania klucza wyszukiwania utworzonego lub zaktualizowanego
data_dozależyciąg (Ymd H: i: s)generalnie opcjonalne, ale wymagane w przypadku używania klucza wyszukiwania utworzonego lub zaktualizowanego
lat_top_leftzależyfloatval (6)generalnie opcjonalne, ale wymagane w przypadku korzystania z pola granicznego wyszukiwania
lon_top_leftzależyfloatval (6)generalnie opcjonalne, ale wymagane w przypadku korzystania z pola granicznego wyszukiwania
lat_bottom_rightzależyfloatval (6)generalnie opcjonalne, ale wymagane w przypadku korzystania z pola granicznego wyszukiwania
lon_bottom_rightzależyfloatval (6)generalnie opcjonalne, ale wymagane w przypadku korzystania z pola granicznego wyszukiwania
powrót do indeksu

Dodatkowe opcje bezpieczeństwa

Interfejs API MapsMarker został zaprojektowany z naciskiem na bezpieczeństwo. Oprócz podstawowej ochrony przy użyciu klucza publicznego i prywatnego, a także wygaśnięcia ważności uwierzytelnienia, możesz opcjonalnie zaostrzyć ustawienia interfejsu API w panelu ustawień w menu Ustawienia / Różne / MapsMarker API: api-security-settings

  • Status API: umożliwia globalne włączenie lub wyłączenie interfejsu API. Domyślnie: wyłączone.
  • Dozwolone akcje API: zezwalaj na użycie tylko tych akcji API, których potrzebujesz. Aktualizuj, usuwaj i wyszukuj akcje są dostępne tylko w wersji pro
  • Ograniczenie dostępu do adresu IP: zezwalaj na dostęp do interfejsu API tylko dla określonego adresu IP lub zakresu adresów IP
  • Dozwolony odsyłacz: dodatkowa warstwa ochrony - zezwól tylko na określonego odsyłacza (uwaga: jeśli jest ustawiony, żądania get nie są już dozwolone!)
  • Dozwolone metody żądania API: opcjonalnie dopuszczaj tylko tę metodę, której potrzebujesz

powrót do indeksu

Odpowiedź

Organem odpowiedzi będzie obiekt JSON (domyślny) lub XML zawierający status powodzenia i wynik żądania. Kod statusu HTTP w nagłówku zawsze będzie wynosił 200, niezależnie od wyniku, dlatego ważne jest sprawdzenie powodzenia w treści odpowiedzi, aby określić powodzenie lub niepowodzenie żądania. Na przykład, jeśli zażądano nieistniejącego markera, surowa treść odpowiedzi byłaby następująca: marker odpowiedzi nie istnieje Pomyślne żądanie formularza może wyglądać następująco: marker odpowiedzi istnieje Jeśli wykonujesz akcję wyszukiwania, wyniki są zwracane jako elementy potomne w atrybucie danych: wyniki wyszukiwania odpowiedzi Jeśli chcesz wyodrębnić zestaw wyników JSONP za pomocą PHP, możesz do tego użyć następującej funkcji: function jsonp_decode($jsonp, $assoc = false) { if($jsonp[0] !== '[' && $jsonp[0] !== '{') { $jsonp = substr($jsonp, strpos($jsonp, '(')); } return json_decode(trim($jsonp,'();'), $assoc); } wykorzystanie: $ data = jsonp_decode ($ zestaw wyników); powrót do indeksu

Przykłady

Poniżej znajduje się przykład pokazujący, jak można korzystać z interfejsu API. Jeśli masz jakieś pytania, proszę otwórz bilet wsparcia!

Żądania GET

  • Wyświetl znacznik z ID2: https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=view&type=marker&id=2
  • Wyświetl warstwę o identyfikatorze 3 w danych wyjściowych XML: https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=view&type=layer&id=2&format=xml
  • Dodaj nowy znacznik, tytuł Siedziba, kod geograficzny Main Street 1 Waszyngton: https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=add&type=marker&markername=Headquarter&geocode=Main Street 1 Washington
  • Dodaj nową warstwę, Sklepy z tytułami, bezpośrednio dodaj lat / lon i adres: https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=add&type=layer&name=Store&lat=48.3434&lon=16.43234&address=Store Adress Washington
  • Zaktualizuj znacznik przy pomocy ID2, ustaw tekst wyskakujący na „nowy tekst wyskakujący” (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=update&type=marker&id=2&popuptext=new popuptext
  • Zaktualizuj warstwę o identyfikatorze 3, ukryj listę markerów pod mapą (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=update&type=layer&id=3&listmarkers=0
  • Usuń znacznik za pomocą ID2 (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=delete&type=marker&id=
  • Usuń warstwę za pomocą ID3 (-> tylko usuń warstwę; tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=delete&type=layer&id=3
  • Usuń warstwę za pomocą ID3 (-> usuń warstwę i przypisane znaczniki; tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=delete&type=layer&id=3&delete_markers=true
  • Wyszukaj wszystkie znaczniki przypisane do warstwy ID 7 (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=search&type=marker&searchkey=layer&searchvalue=7
  • Wyszukaj wszystkie warstwy za pomocą name = test (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=search&type=layer&searchkey=name&searchvalue=test
  • Wyszukaj wszystkie znaczniki, które zostały utworzone po 2013, 10:01:12 i przed 00, 00:2014:01 (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=search&type=marker&searchkey=createdon&date_from=2013-10-01 12:00:00&date_to=2014-01-01 12:00:00
  • Wyszukaj wszystkie znaczniki w obwiedni (tylko wersja pro): https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php?key=YOUR_PUBLIC_KEY&signature=YOUR_SIGNATURE&expires=YOUR_EXPIRE_VALUE&action=search&type=marker&searchkey=boundingbox&lat_top_left=48.283543&lon_top_left=16.228180&lat_bottom_right=48.081642&lon_bottom_right=16.640854

powrót do indeksu

Żądania POST:

Możesz także użyć żądania POST, aby wywołać API Markera map - podczas gdy możesz użyć tych samych parametrów, co w powyższych przykładach żądania GET. Te parametry można dodać do formularza HTML, na przykład: Wyświetl znacznik o ID1: <form action="https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php" method="POST"> <input type="hidden" name="key" value="YOUR_PUBLIC_KEY"/> <input type="hidden" name="signature" value="YOUR_SIGNATURE"/> <input type="hidden" name="expires" value="YOUR_EXPIRE_VALUE"/> <input type="text" name="action" value="view"/> <input type="text" name="type" value="marker"/> <input type = "text" name = "id" value = "1" /> <input type="submit" name="submit" value="submit"/> </form> Dodaj nowy znacznik, tytuł Siedziba, kod geograficzny Main Street 1 Waszyngton: <form action="https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php" method="POST"> <input type="hidden" name="key" value="YOUR_PUBLIC_KEY"/> <input type="hidden" name="signature" value="YOUR_SIGNATURE"/> <input type="hidden" name="expires" value="YOUR_EXPIRE_VALUE"/> <input type="text" name="action" value="add"/> <input type="text" name="type" value="marker"/> <input type = "text" name = "markername" value = "Headquarters" /> <input type = "text" name = "geocode" value = "Main Street 1 Washington" /> <input type="submit" name="submit" value="submit"/> </form> Zaktualizuj znacznik przy pomocy ID2, ustaw tekst wyskakujący na „nowy tekst wyskakujący” (tylko wersja pro): <form action="https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php" method="POST"> <input type="hidden" name="key" value="YOUR_PUBLIC_KEY"/> <input type="hidden" name="signature" value="YOUR_SIGNATURE"/> <input type="hidden" name="expires" value="YOUR_EXPIRE_VALUE"/> <input type="text" name="action" value="update"/> <input type="text" name="type" value="marker"/> <input type = "text" name = "id" value = "2" /> <input type = "text" name = "popuptext" value = "new popuptext" /> <input type="submit" name="submit" value="submit"/> </form> Wyszukaj wszystkie znaczniki przypisane do warstwy ID 7 (tylko wersja pro): <form action="https://your-domain/wp-content/plugins/leaflet-maps-marker-pro/leaflet-api.php" method="POST"> <input type="hidden" name="key" value="YOUR_PUBLIC_KEY"/> <input type="hidden" name="signature" value="YOUR_SIGNATURE"/> <input type="hidden" name="expires" value="YOUR_EXPIRE_VALUE"/> <input type="text" name="action" value="search"/> <input type="text" name="type" value="marker"/> <input type = "text" name = "searchkey" value = "layer" /> <input type = "text" name = "searchvalue" value = "7" /> <input type="submit" name="submit" value="submit"/> </form> powrót do indeksu

1
0
6066
Oceń to odniesienie

Nie możesz oceniać tego posta.

Zostaw komentarz

XHTML: Możesz użyć tych tagów: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>

en English
X