Uzyskaj bezpłatne geokodowanie na poziomie przedsiębiorstwa za pomocą interfejsu Positionstack API (PRZEGLĄD)

Nie musisz być Google Maps, aby czerpać korzyści z geokodowania. A dzięki Positionstack nie potrzebujesz do tego budżetu technologicznego Big G. Dzisiaj dokonujemy przeglądu solidnego interfejsu API Positionstack, którego celem jest uczynienie geokodowania w przód i wstecz na poziomie przedsiębiorstwa, zarówno w przystępnej cenie, jak i użytecznej.

Stos pozycji 101

Dlaczego więc miałbyś zawracać sobie głowę czytaniem ponad 2000 słów recenzji na Positionstack i co możesz zyskać? Odpowiedź brzmi słodkie, ale to dokładna: na cały świat .

Zastanów się przez chwilę, ile miejsc jest na mapie świata. Teraz pomnóż tę liczbę w swojej głowie przez każdy element metadanych, które Twoja firma musi znać na temat tych miejsc. To właśnie oferuje Positionstack, a nawet więcej.

Spójrzmy na kilka szybkich statystyk dotyczących Positionstack:

• Rzeczywiste miliardy żądań wyszukiwania geokodowania przetwarzanych co godzinę, każdego dnia; ze 100% czasem pracy bez przestojów i < 100ms="" response="">
• Wysoce skalowalna infrastruktura oparta na chmurze
• Dane w czasie rzeczywistym dotyczące każdego kraju na świecie, zebrane w przepastny zbiór danych, który jest aktualizowany co kilka godzin
• Hojnie podzielone, konkurencyjne cenowo plany subskrypcji; plus niezrównany miesięczny limit 10 000 żądań dla użytkowników bezpłatnych
• Wsparcie integracji dla wszystkich głównych języków programowania
• Kompleksowa, łatwa do odczytania dokumentacja wraz z fragmentami kodu
• Światowej klasy zespół ds. zadowolenia klientów z doświadczeniem w obsłudze klientów takich jak Zendesk, Slack, LinkedIn, Lyft, Apple i Amazon

Positionstack z pewnością ma swój rodowód w ryzach, ale jeśli nie jesteś przekonany kilkoma punktami, przyjrzyjmy się, jak to jest faktycznie korzystać z API.

3-etapowy przewodnik szybkiego startu Positionstack

Jeśli spędzisz jakiś czas na ich stronie internetowej, zobaczysz, że Positionstack naprawdę podkreśla łatwość użycia jako główny punkt sprzedaży ich API. Podczas procesu rejestracji od razu zobaczysz, że to prawda. W rzeczywistości pierwszą rzeczą, którą widzisz po wpisaniu danych logowania do konta, jest szybki plan działania w trzech prostych krokach, aby zacząć korzystać z Positionstack. Spójrzmy:

1. Ustaw klucz dostępu do interfejsu API — domyślnie otrzymujesz klucz dostępu gotowy do użycia po wyjęciu z pudełka. Możesz jednak łatwo zresetować to w razie potrzeby.
2. Wybierz punkty końcowe API — omówimy punkty końcowe API bardziej szczegółowo w następnej sekcji, ale na razie po prostu zrozum, że ten krok dotyczy konfiguracji, jaki typ danych jest zwracany, gdy Twoja aplikacja wysyła żądanie do Positionstack. Tutaj najpierw zobaczysz podstawowy adres URL, na który kierujesz swoje żądania, ale pojawia się on również w dokumentacji. Na koniec widzimy przykładowe żądanie API, które składa się z zaledwie kilku prostych linijek kodu.
3. Integracja aplikacji – Ostatni krok dotyczy ostatecznej integracji API Positionstack z Twoją aplikacją. Jest sporo informacji o tym procesie, a większość z nich jest opisana w dokumentacji. Ważną rzeczą jest to, że zespół wsparcia Positionstack wspiera Cię i zaoferuje tyle, ile tylko niewielką pomoc, jakiej potrzebujesz, aby skonfigurować i zintegrować ich API z Twoją aplikacją.

Całkiem łatwe, prawda? Interfejsy API mogą początkowo wydawać się onieśmielające osobom bez rozległej wiedzy informatycznej. Ale od samego początku Positionstack pociesza Cię wiedzą, że nie tylko jest to łatwe, ale pomoże Ci w drodze dzięki niesamowitej dokumentacji ich inteligentnego projektu. Pomaga im również mieć pełen pasji zespół ekspertów, którzy są gotowi do pomocy również Tobie.

Twój pulpit nawigacyjny ze stosem pozycji

Podwajając swoją podstawową wartość przyjazności dla użytkownika, Positionstack oferuje uproszczony, uporządkowany pulpit nawigacyjny, z którego możesz uzyskać dostęp do wszystkiego, co musisz wiedzieć o swoim API. Rzućmy okiem na opcje paska bocznego:

• Pulpit nawigacyjny — tutaj znajdziesz powiadomienia (zwykle ostrzegające o przekroczeniu określonych progów użytkowania), a następnie łącza do przewodnika Szybki start w 3 krokach i ich strony Dokumentacja. Dostępny jest również przegląd Twojego klucza API, aktualnej subskrypcji, szczegółów konta i metody płatności.
• Uaktualnienie/Subskrypcja — możesz zmienić swoją subskrypcję na jedną z tych dwóch opcji. Uaktualnij w dowolnym momencie, ale jeśli chcesz przełączyć się między planem miesięcznym lub rocznym w dowolnym kierunku, musisz najpierw przejść na konto bezpłatne, a następnie wybrać żądaną opcję. Wsparcie Positionstack jest chętne do pomocy, jeśli potrzebujesz pomocy w tym zakresie.
• Konto/Płatność – nie wymagają wyjaśnień; każda zakładka pozwoli Ci zaktualizować swoje dane uwierzytelniające w dowolnym momencie. Trzeba powiedzieć, że doceniamy to, że nie ukrywają tych podstawowych elementów sterujących w przeprojektowanym, krzykliwym interfejsie. WYSIWYG.
• Wykorzystanie interfejsu API — prawdopodobnie zakładka, do której będziesz wracać najczęściej, tutaj możesz sprawdzić, ile z miesięcznego limitu żądań zjadłeś do tej pory. Dostępna jest również przydatna sekcja przedstawiająca statystyki użytkowania w czasie, dzięki czemu możesz odpowiednio dostosować swoją strategię.

Dokumentacja API

Teraz dochodzimy do sedna i duszy oferty Positionstack: dokumentacji API . Potraktuj tę stronę jako podręcznik użytkownika, który szczegółowo opisuje każdy punkt końcowy interfejsu API, jego parametry i rodzaj informacji, które zwrócą.

Ta strona jest podzielona na pięć różnych sekcji. Przejdziemy przez każdy z nich, poświęcając trochę czasu i słów, aby przedstawić kontekst, abyś mógł lepiej zrozumieć, co znajdziesz.

Pierwsze kroki

Tutaj znajdziesz podstawowe funkcje, które mają zastosowanie do każdego żądania, które złożysz za pomocą Positionstack. To są:

• Klucz API – Twój klucz API jest jak cyfrowy paszport, którego będziesz używać do uzyskiwania dostępu do zestawu danych Positionstack. Bez tego API jest dla Ciebie bezużyteczne. Jeśli uważasz, że zostało naruszone, możesz łatwo wymienić stary klucz na nowy.
• Szyfrowanie – 256-bitowe szyfrowanie SSL jest używane w całym Internecie i nie bez powodu jest branżowym standardem bezpieczeństwa. Chociaż będziesz potrzebować planu Basic lub lepszego, aby zaszyfrować komunikację swojej aplikacji z serwerami Positionstack, warto zainwestować samodzielnie. Aby wywołać szyfrowanie, po prostu zmień HTTP na HTTPS w podstawowym adresie URL API. Prosty!
• Wywołania zwrotne JSON — nie będziemy wchodzić w zbyt wiele szczegółów technicznych dotyczących tego, jak to działa, ale jeśli żądania interfejsu API są blokowane przez zasady tego samego pochodzenia, używasz wywołań zwrotnych JSON, aby wpłynąć na obejście. Zasadniczo żądasz danych z zewnętrznego skryptu, który nie ugrzęźnie w problemach międzydomenowych.
• Błędy API – Jak ze wszystkim, czasami Twoje żądania API będą powodować błędy. Positionstack rozumie to i wbudował w swoją aplikację funkcję raportowania błędów, która pomoże Ci zidentyfikować, co poszło nie tak. Błędy żądań API automatycznie zwrócą obiekt błędu w formacie JSON oraz podobiekty kodu, komunikatu i kontekstu, aby zapewnić kontekst błędu.

Punkty końcowe API

Ta sekcja dokumentuje funkcjonalność Positionstack dla mięsa i ziemniaków, czyli geokodowanie w przód i w tył. Jeśli nie jesteś w 100% pewien, jaka jest różnica, pomyśl o geokodowaniu jako o dwukierunkowej ulicy, na której możesz tłumaczyć miejsca i adresy napisane prostym językiem angielskim na dane o lokalizacji, takie jak współrzędne i adresy IP, i odwrotnie.

Tak więc użyłbyś geokodowania do przodu, aby przekonwertować lokalizację Wieży Eiffla na współrzędne. Podobnie możesz znaleźć adres ulicy powiązany z adresem IP, używając odwrotnego geokodowania. W końcu całkiem proste!

Żądania geokodowania w przód/wstecz

Aby wysłać podstawowe żądanie dla dowolnego typu geokodowania, musisz dołączyć odpowiedni punkt końcowy ( /forward  lub /reverse ) do podstawowego adresu URL interfejsu API. Następnie podasz swój klucz dostępu, a następnie wykonaj zapytanie, używając adresu lokalizacji w prostym języku angielskim lub odpowiadających mu danych 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

lub

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ż tylko adresy i współrzędne. Możesz analizować te inne kategorie przy użyciu różnych parametrów. Oto przykład tego , jak wygląda forwardowe żądanie geokodowania skierowane do Białego Domu:

{
   "dane": {
      "wyniki": [
         {
            „szerokość geograficzna”: 38,897675,
            "długość geograficzna": -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",
            "obszar_administracyjny": null,
            "sąsiedztwo": "Tereny Białego Domu",
            „kraj”: „Stany Zjednoczone”,
            "country_code": "USA",
            "map_url": "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

Co ciekawe, gdybyś wykonał żądanie odwrotnego geokodowania przy użyciu przybliżonych współrzędnych Białego Domu, zwrócone wyniki wyglądałyby prawie identycznie, z wyjątkiem tego, że zobaczysz również różnicę odległości między twoimi współrzędnymi a oficjalnymi współrzędnymi Białego Domu, tak jak są one wyświetlane w Positionstack zbiór danych.

Powodem tego podobieństwa jest to, że oba punkty końcowe wykorzystują tę samą tablicę parametrów GET, a zatem są w stanie zwrócić (prawie) te same obiekty odpowiedzi. Oznacza to, że bez względu na to, jakie dane początkowe musisz przejść, możesz w zamian uzyskać pełny zestaw danych o lokalizacji. (Możliwe jest zawężenie tych wyników za pomocą parametru pól  interfejsu API , ale omówimy to później).

Uwaga: Strona dokumentacji Positionstack szczegółowo opisuje każdy parametr i obiekt odpowiedzi, więc koniecznie sprawdź to!

Żądania wsadowe

Ostatni główny nagłówek w tym ustawieniu dokumentacji dotyczy żądań wsadowych . Wszystko, co musisz zrobić, to wywołać parametr wsadowy  , a następnie zagnieździć wiele wystąpień zapytania (wraz z żądanymi parametrami) poniżej w jednym żądaniu, a API Positionstack zajmie się resztą. To bardzo proste i wygląda tak:

{
   "partia":[
      {
         "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 parametrów lokalizacji możesz dodatkowo dostosować żądania API, aby zwracały bardziej zaawansowane dane . Obejmują one:

• Mapy osadzone — zwraca obiekt map_url powiązany z wynikiem geokodowania, którego można użyć do stworzenia atrakcyjnej wizualnej reprezentacji mapy w witrynie lub aplikacji.
• Moduł kraju — w przeciwieństwie do innych parametrów, które zwracają do kilku obiektów odpowiedzi, moduł_krajowy zwraca niesamowitą tablicę danych o kraju, którego dotyczy zapytanie. To nie tylko współrzędne i adresy; to stolica, flaga, oficjalna nazwa, status kraju śródlądowego (lub nie), używane waluty, używane języki, kody telefoniczne i inne.
• Moduł Słońca – humorystycznie, dokumentacja Positionstack opisuje to jako dane „astrologiczne”. Nie otrzymasz horoskopu z tym parametrem, ale zobaczysz dane o wschodzie i zachodzie słońca zgodnie z chronologią astronomiczną, cywilną i morską.
• Moduł strefy czasowej — dołącz timezone_module, aby zwrócić przesunięcie GMT lokalizacji w sekundach lub jako ciąg języka naturalnego.
• Moduł ramki granicznej — jeśli pojedyncza para współrzędnych x/y nie jest odpowiednia dla twojego zadania, wypróbuj ramkę graniczną, która obejmuje obszar z minimalnymi i maksymalnymi wartościami długości i szerokości geograficznej.

Dodatkowe opcje

Interfejs API Positionstack oferuje mnóstwo danych, ale na szczęście zapewnia dodatkowe narzędzia do zarządzania tą skarbnicą informacji.

• Określ pola odpowiedzi — szczegółowo omówiliśmy, ile danych Positionstack może zwrócić, ale pamiętaj, że wszystkie te dane mają swoją cenę. Jeśli chcesz ograniczyć liczbę żądań miesięcznych, możesz to zrobić na przykład za pomocą pól Dołączanie pól = results.flag , co spowoduje, że interfejs API wyśle ​​tylko flagę kraju, z którego pochodzi zapytanie. Możesz wywoływać pola tyle razy, ile potrzebujesz, aby uzyskać określony zestaw danych, którego potrzebujesz.
• Określ format wyjściowy — Bezpłatni subskrybenci są ograniczeni do formatu JSON dla zwróconych wyników geokodowania. Płacący klienci mogą jednak dołączyć dane wyjściowe do swoich żądań, aby w razie potrzeby określić JSON, XML lub GeoJSON. 

Przykłady kodu 

Kiedy Positionstack mówi, że jest tutaj, aby Ci pomóc, naprawdę to rozumie. Widzieliśmy już, jak dokładna jest ich dokumentacja, ale uzupełniają ją przydatnymi przykładami kodu we wszystkich językach obsługiwanych przez ich interfejs API. Nie będziemy tutaj kopiować/wklejać tego kodu, ale dla szybkiego odniesienia, te języki to:

• Pyton
• Nodejs
• jQuery
• Iść
• Rubin

Dowód i wydajność

W tym momencie powinno być jasne, że Positionstack jest w stanie zrobić całkiem dużo. Ale jak dobrze to robi?

Najpierw rozważmy kontekst. Positionstack to jedna z ponad 20 mikrousług API w ekosystemie chmurowym Apilayer. Razem te interfejsy API obsługują ponad milion klientów B2B, od startupów po przedsiębiorstwa. Niektórzy z ich najbardziej znanych klientów to Amazon, Apple, Slack, LinkedIn i wiele innych znanych marek. Najwyraźniej mają solidną infrastrukturę, aby poradzić sobie z taką skalą popytu.

Dzięki swoim zaletom Positionstack zasługuje na swój rodowód, z niesamowitym 100% czasem sprawności przez cały rok 2020 w momencie pisania. Jest to jeszcze bardziej imponujące, jeśli weźmie się pod uwagę, że interfejs API rutynowo przetwarza ponad miliard wyszukiwań geokodów dziennie na klienta wieloryba, nie wspominając o oszałamiającej liczbie jednoczesnych żądań pochodzących od ich stajni klientów SMB. Co więcej, te żądania zwykle zbierają odpowiedzi od 10 do 100 ms.

W naszej książce jest to coś w rodzaju cudu technologicznego, zwłaszcza biorąc pod uwagę agresywną cenę tej oferty SaaS.

I to nie tylko czysta moc sprawia, że ​​Positionstack jest tak atrakcyjny. Ich zestaw danych jest naprawdę wyrafinowany, pochodzący od wiarygodnych nazw, takich jak Nominatim, GeoNames, Pelias i OpenStreetMap. Positionstack sprawdza krzyżowo, filtruje i ponownie łączy to bogactwo danych wiele razy dziennie, wysyłając regularne aktualizacje za pomocą inteligentnych algorytmów, które zapewniają, że zawsze masz bardzo dokładne dane o lokalizacji, w dowolnym miejscu na świecie i w czasie rzeczywistym.

Nie chcemy psuć naszego ostatecznego werdyktu, ale jeśli szukasz solidnego, skalowalnego rozwiązania do geokodowania, CV Positionstack wymaga bliższego przyjrzenia się.

cennik 

Apilayer postanowił zapewnić przystępną cenowo alternatywę dla bardzo drogiego oprogramowania do geokodowania na poziomie korporacyjnym i pod tym względem odnieśli sukces.

Positionstack jest dostępny w pięciu poziomach cenowych i obsługuje miesięczne rozliczenia lub roczne subskrypcje z 20% zniżką. Te poziomy to:

• Bezpłatna — przeznaczona do użytku osobistego, nadal uzyskujesz spory przebieg dzięki 25 000 miesięcznych żądań dotyczących geokodowania w przód i wstecz, wyprowadzanych w formacie JSON. Nie otrzymujesz wielu zaawansowanych funkcji ani obsługi klienta, ale pokazaliśmy już, jak cennym zasobem jest ich strona Dokumentacja. Ten poziom jest bezpłatny i niezobowiązujący — nie musisz nawet podawać danych karty kredytowej, aby rozpocząć.
• Basic — podstawowy pakiet komercyjny. Subskrybenci podstawowi czterokrotnie zwiększają swój miesięczny limit do 100 000 żądań geokodowania, a także uzyskują dostęp do zaawansowanych funkcji, takich jak szyfrowanie HTTPS, wiele opcji wyjściowych (JSON, XML, GeoJSON), mapy do osadzenia, wiele języków i nie tylko. Uzyskaj komercyjną licencję Positionstack za jedyne 9,99 USD miesięcznie.
• Professional — najpopularniejsza oferta Positionstack, warstwa Professional oferuje dziesięciokrotny wzrost żądań geokodowania — do 1 000 000 miesięcznie. Wszystkie dodatki z warstwy Podstawowa są obecne, a następnie niektóre, w tym w szczególności żądania wsadowe dla aplikacji o dużym obciążeniu. Ten poziom osiąga 49,99 USD miesięcznie.
• Biznes — Przechodząc do wydajności na skalę korporacyjną, warstwa Biznes zwiększa miesięczny przydział do ogromnej liczby 3 000 000 żądań. Po raz kolejny każda zaawansowana funkcja jest w pełni dostępna, wspierana przez pełen pasji zespół obsługi klienta Positionstack, aby pomóc Ci w pełni je wykorzystać. 99,99 USD miesięcznie.
• Enterprise – to poziom, w którym standardowe oferty wychodzą przez okno, a klient jest królem. Masz precyzyjne potrzeby, które wymagają niestandardowych rozwiązań, a Positionstack jest gotowy do osiągnięcia Twoich celów. Ty dyktujesz swoje miesięczne żądania ilościowe, nawet (zwłaszcza) jeśli są zmienne. Potrzebujesz więcej koni mechanicznych z API? Skontaktuj się z pomocą techniczną dla niestandardowych rozwiązań. Skontaktuj się z Positionstack, aby uzyskać wycenę.

Werdykt

Positionstack robi dokładnie to, co zamierzał: obniżyć geokodowanie na poziomie przedsiębiorstwa z punktów cenowych, które w przeciwnym razie nie byłyby dostępne w budżecie, dla większości małych i średnich firm, bez poświęcania wydajności. Ich interfejs API jest dobrze udokumentowany i łatwy w użyciu, ale oferuje solidną integrację ze wszystkimi głównymi językami programowania w celu uzyskania maksymalnej użyteczności. Liczba żądań, które Positionstack rutynowo obsługuje, jest oszałamiająca, podczas gdy ich zestaw danych jest inteligentnie utrzymywany w celu zapewnienia prawdziwie globalnego zasięgu w geokodowaniu w czasie rzeczywistym. Jeśli jesteś na rynku tego typu produktów, nie śpij na Positionstack.

Jaką integrację zaplanowałeś? Jak wykorzystasz geokodowanie w swoim biznesie? Masz pytania lub uwagi dotyczące Positionstack? Zostaw nam notatkę w komentarzach poniżej.