Nie musisz być Google Maps, aby skorzystać z geokodowania. A dzięki Positionstack nie potrzebujesz do tego budżetu technologii Big G. Dzisiaj przyjrzymy się potężnemu interfejsowi Positionstack API, którego celem jest uczynienie geokodowania natychmiastowego i odwróconego korporacyjnej jakości bardzo przystępnym cenowo i użytecznym.
Stos przedmiotów 101
Po co więc zawracać sobie głowę czytaniem ponad 2000 słów recenzji? Stos przedmiotów a co możesz zyskać? Odpowiedź jest prawidłowa, ale poprawna: le monde entier .
Poświęć trochę czasu na przyjrzenie się liczbie lokacji na mapie świata. Teraz pomnóż tę liczbę w swojej głowie przez każdy element metadanych, który Twoja firma musi wiedzieć o tych miejscach. To właśnie oferuje Positionstack i nie tylko.
Oto kilka szybkich statystyk dotyczących Positionstack:
- Miliardy żądań wyszukiwania geokodowania są przetwarzane co godzinę, każdego dnia. ze 100% czasem pracy i czasem odpowiedzi <100 ms
- Wysoko skalowalna infrastruktura chmurowa
- Dane w czasie rzeczywistym z całego świata, gromadzone w dużym zestawie danych aktualizowanym co kilka godzin.
- Hojnie dystrybuowane i konkurencyjne programy subskrypcji. plus bezkonkurencyjna miesięczna stawka 10 000 darmowych żądań użytkowników
- Wsparcie integracji dla wszystkich głównych języków programowania
- Kompleksowa, łatwa do odczytania dokumentacja z fragmentami kodu
- Światowej klasy zespół ds. satysfakcji klientów z doświadczeniem w obsłudze klienta, taki jak Zendesk, Slack, LinkedIn, Lyft, Apple i Amazon.
Positionstack zdecydowanie ma swoją genealogię pod kontrolą, ale jeśli nie przekonuje Cię garść kropek, przyjrzyjmy się, jak naprawdę wygląda korzystanie z API.
Positionstack 3-stopniowa skrócona instrukcja obsługi
Jeśli spędzisz trochę czasu na swojej stronie, przekonasz się, że Positionstack naprawdę kładzie nacisk na łatwość użycia jako główny punkt sprzedaży swojego API. Podczas procesu rejestracji od razu zobaczysz, że to absolutnie prawda. W rzeczywistości pierwszą rzeczą, którą widzisz podczas wprowadzania danych uwierzytelniających do konta, jest szybki plan tego, czego potrzebujesz, aby rozpocząć pracę z Positionstack w trzech prostych krokach. Zobaczymy:
- Określ API — według klucza domyślnie dostajesz klucz dostępu gotowy do użycia. W razie potrzeby możesz go jednak łatwo zresetować później.
- Wybierz punkty końcowe interfejsu API – Bardziej szczegółowo omawiamy punkty końcowe API w następnej sekcji, ale na razie po prostu zrozum, że ten krok jest związany z konfiguracją typu danych, który jest zwracany, gdy twoja aplikacja żąda Positionstack. Tutaj najpierw zobaczysz podstawowy adres URL, do którego kierujesz swoje żądania, ale pojawia się on również w dokumentacji. Na koniec widzimy przykładowe żądanie API składające się z kilku linijek kodu.
- Integracja aplikacji – Ostatni krok dotyczy ostatecznej integracji Positionstack API z Twoją aplikacją. Jest wiele rzeczy, które musisz wiedzieć o tym procesie, z których większość jest opisana w dokumentacji. Najważniejsze jest to, że zespół wsparcia Positionstack jest za tobą i zapewni tyle lub najmniej pomocy, ile potrzebujesz, aby skonfigurować i zintegrować twoje API z twoją aplikacją.
Bardzo proste, prawda? Interfejsy API mogą początkowo wydawać się onieśmielające osobom, które nie mają dogłębnych umiejętności obsługi komputera. Ale od samego początku Positionstack zapewnia nie tylko to, że jest to łatwe, ale pomoże Ci w drodze dzięki niesamowitej dokumentacji ich sprytnego projektu. W rezultacie mają zespół pełnych pasji ekspertów gotowych również Tobie pomóc.
Stół stosu twoich przedmiotów
Podwajając podstawową wartość łatwości użytkowania, Positionstack oferuje uproszczony, ustrukturyzowany pulpit nawigacyjny, z którego możesz uzyskać dostęp do wszystkiego, co musisz wiedzieć o jego interfejsie API. Rzućmy okiem na opcje paska bocznego:
- deska rozdzielcza – Tutaj znajdziesz alerty (które zwykle ostrzegają, gdy przekroczysz określone limity użytkowania), a następnie linki do 3-stopniowego przewodnika szybkiego startu i jego strony z dokumentacją. Dostępny jest również przegląd klucza API, aktualnej subskrypcji, danych konta i metody płatności.
- Aktualizacja / subskrypcja : Możesz zmienić swoją subskrypcję na jedną z tych dwóch opcji. Uaktualnij w dowolnym momencie, ale jeśli chcesz przełączać się między programem miesięcznym a rocznym w obu kierunkach, musisz najpierw przejść na darmowe konto, a następnie wybrać żądaną opcję. Wsparcie Positionstack jest gotowe do pomocy, jeśli potrzebujesz pomocy.
- Płatność faktury : Jasne? jedna z zakładek pozwoli Ci w dowolnym momencie zaktualizować swoje dane uwierzytelniające. Nie trzeba dodawać, że doceniamy to, że nie ukrywają tych kluczowych elementów sterujących w fantazyjnym i przesadnie zaprojektowanym interfejsie. WYSIWYG.
- Użyj API – Zapewne zakładka, do której będziesz wracał najczęściej, tutaj znajdziesz miesięczne opłaty za zarządzanie, z których korzystałeś do tej pory. Istnieje również przydatna sekcja, która wyświetla statystyki użytkowania w czasie, dzięki czemu możesz odpowiednio dostosować swoją strategię.
Dokumentacja API
Teraz dochodzimy do sedna i duszy oferty Positionstack: La dokumentacja «NS API . Pomyśl o tej stronie jak o podręczniku użytkownika, który zawiera listę każdego punktu końcowego interfejsu API, jego parametrów i typu zwracanych informacji.
Ta strona jest podzielona na pięć różnych sekcji. Omówimy każdy z nich i poświęcimy trochę czasu i słów, aby wprowadzić Cię w kontekst, abyś mógł lepiej zrozumieć, co znajdziesz.
Zbaczać
Znajdziesz to tutaj podstawowe funkcje związane z każdym żądaniem złożonym przez Positionstack. To są:
- Clé API – Twój klucz API wygląda jak cyfrowy paszport, którego będziesz używać, aby uzyskać dostęp do zestawu danych Positionstack. Bez tego API jest dla Ciebie bezużyteczne. Jeśli uważasz, że został naruszony, możesz łatwo wymienić stary klucz na nowy.
- Szyfrowanie : 256-bitowe szyfrowanie SSL jest używane w całym Internecie i z jakiegoś powodu jest standardem branżowym. Chociaż możesz potrzebować podstawowego lub wyższego planu do szyfrowania komunikacji aplikacji z serwerami Positionstack, inwestycja jest tego warta. Aby mówić o szyfrowaniu, po prostu zmień HTTP na HTTPS w głównym adresie URL API. Wygodny!
- Przypomnienia JSON – Nie będziemy wchodzić w zbyt wiele szczegółów technicznych dotyczących tego, jak to działa, ale jeśli żądania API są wykluczone z tej samej polityki źródłowej, użyj przekierowań JSON, aby przypisać rozwiązanie. Zasadniczo prosi o dane z zewnętrznego skryptu, który nie utknie w kwestiach międzydomenowych.
- Błędy API – Jak ze wszystkim, twoje żądania API napotkają sporadyczne błędy. Positionstack rozumie to i ma wbudowaną funkcję raportowania błędów, która pomoże Ci dowiedzieć się, co się dzieje. Błędy żądań API automatycznie zwrócą obiekt błędu w formacie JSON wraz z podpodziałami kodu, wiadomości i środowiska w celu dostarczenia ramki błędu.
Punkty końcowe API
Ta sekcja opisuje funkcjonalność Positionstack dla mięsa i ziemniaków, tj. geokodowanie bezpośrednie i odwrotne. Jeśli nie jesteś w 100% pewien różnicy, rozważ geokodowanie jako dwukierunkową ulicę, w której możesz przetłumaczyć miejsca i adresy zapisane prostym językiem angielskim na dane o lokalizacji, takie jak współrzędne i adresy IP i odwrotnie.
Więc użyłbyś bezpośredniego geokodowania, aby przekonwertować lokalizację Wieży Eiffla na współrzędne. Podobnie możesz znaleźć adres pocztowy powiązany z adresem IP z odwrotnym geokodowaniem. Mimo wszystko całkiem proste!
Żądania bezpośredniego/odwrotnego geokodowania
Aby złożyć podstawowe żądanie dowolnego typu geokodowania, musisz dodać odpowiedni punkt końcowy ( / Do przodu ten tył ) w adresie URL głównego interfejsu API. Następnie wpiszesz swoje hasło, a następnie zakończysz poprosić o używając normalnego angielskiego adresu strony lub odpowiednich danych o lokalizacji i voila! Będzie to wyglądać mniej więcej tak:
https://api.positionstack.com/v1/forward ? klucz_dostępu = TWÓJ_KLUCZ_DOSTĘPU & zapytanie = 1600 Pennsylvania Ave NW, Waszyngton DC
my
https://api.positionstack.com/v1/reverse ? klucz_dostępu = TWÓJ_KLUCZ_DOSTĘPU & zapytanie = 40.7638435, -73.9729691
Oczywiście zbiór danych Positionstack zawiera znacznie więcej niż adresy i współrzędne. Możesz analizować te inne kategorie za pomocą różnych parametrów. Oto przykład tego, co nadać cechy osobiste natychmiastowe geokodowanie podanie wygląd zewnętrzny , widziana przez Biały Dom:
{ „Dane”: { "wyniki": [ { „szerokość geograficzna”: 38,897675, „długość”: -77,036547, "label": "1600 Pennsylvania Avenue NW, Waszyngton, DC, USA", "nazwa": "1600 Pennsylvania Avenue NW", "typ": "adres", "liczba": "1600", "ulica": "Pennsylvania Avenue NW", "kod_pocztowy": "20500", "zaufanie": 1, "region": "Dystrykt Kolumbii", "region_code": "DC", "area_administrativa": null, „dzielnica”: „miejsce Białego Domu”, "Kraj: Stany Zjednoczone", "kod_kraju": "USA", "map_url": "https://map.positionstack.com/38.897675,-77.036547" } ] } }
Ciekawe, jeśli tak Praca odwrotne geokodowanie v korzystając z przybliżonych współrzędnych Białego Domu, zwrócone wyniki będą wyglądały prawie tak samo, z tym że widać również różnicę w dystans między Twoimi danymi kontaktowymi a oficjalnymi danymi kontaktowymi Białego Domu, gdy się pojawią. w stosie pozycji. Baza danych.
Powodem tego podobieństwa jest to, że oba końce używają tej samej tabeli parametrów GET i dlatego są w stanie zwrócić (prawie) te same obiekty odpowiedzi. Oznacza to, że niezależnie od początkowych danych, których potrzebujesz, możesz w zamian otrzymać kompletny zestaw danych lokalizacyjnych. (Możliwe jest ograniczenie tych wyników do «NS asystent ty parametr Klapka API ale omówimy to później.)
Uwaga: Strona dokumentacji Positionstack opisuje szczegółowo każdą konfigurację i element odpowiedzi, więc koniecznie sprawdź to!
Żądania wsadowe
Ostatni ważny tytuł tej konfiguracji dokumentacji dotyczy wymagania z wiele . Wszystko, co musisz zrobić, to zadzwonić parametr impreza a potem zagnieździć trochę sprawy raport (z żądanymi parametrami) poniżej w żądaniu, a Positionstack API zajmie się resztą. To bardzo proste i wygląda tak:
{ "los":[ { "zapytanie": "Główna ulica", "kraj": "USA", "region": "Minnesota" }, { "zapytanie": "Główna ulica", "kraj": "USA", "region": "Illinois" }, { "zapytanie": "Główna ulica", "kraj": "USA", "region": "Missouri" } ] }
Zaawansowane dane
Oprócz podstawowych ustawień lokalizacji możesz dodatkowo dostosować żądania API do alternatywnych Z podarowany plus postęp . Zawiera:
- Karty embeddable — zwraca obiekt map_url powiązany z wynikiem geokodowania, który można wykorzystać do stworzenia atrakcyjnej wizualnej reprezentacji mapy w witrynie lub aplikacji.
- Jedność kraju : w przeciwieństwie do niektórych innych parametrów zwracanych przez niektóre obiekty odpowiedzi, moduł_kraju zwraca zadziwiającą różnorodność danych dla badanego kraju. To nie tylko kwestia współrzędnych i kierunków. To jest stolica, flaga, oficjalna nazwa, kraj śródziemnomorski (lub nie), używane waluty, używane języki, kody telefoniczne i inne.
- Jednostka słoneczna : Dokumentacja Positionstack żartobliwie opisuje to jako dane „astrologiczne”. Nie będziesz mieć horoskopu z tym ustawieniem, ale zobaczysz dane dotyczące wschodu i zachodu zgodnie z harmonogramami astronomicznymi, politycznymi i morskimi.
- Jednostka miary wrzeciono Horaire : Dodać