Holen Sie sich mit der Positionstack-API (REVIEW) kostenlos Geokodierung auf Unternehmensebene

Sie müssen nicht Google Maps sein, um Wert aus der Geokodierung zu ziehen. Und dank Positionstack benötigen Sie dazu auch nicht das Tech-Budget des Big G. Heute überprüfen wir die robuste API von Positionstack, mit der die Vorwärts- und Rückwärts-Geokodierung auf Unternehmensebene sowohl äußerst erschwinglich als auch nutzbar gemacht werden soll.

Positionstack 101

Warum sollten Sie sich also die Mühe machen, eine Rezension mit mehr als 2.000 Wörtern zu lesen? Positionstackund was können Sie gewinnen? Die Antwort klingt süß, ist aber richtig: das ganze Welt.

Überlegen Sie sich für einen Moment, wie viele Orte sich auf der Weltkarte befinden. Multiplizieren Sie diese Zahl in Ihrem Kopf mit jedem Metadatenelement, das Ihr Unternehmen über diese Orte wissen muss. Das bietet Positionstack und noch viel mehr.

Schauen wir uns einige kurze Statistiken zu Positionstack an:

• Tatsächlich werden Milliarden von Geokodierungs-Suchanfragen stündlich und täglich verarbeitet. mit 100% Betriebszeit und <100 ms Reaktionszeiten
instagram viewer
• Cloud-basierte, hoch skalierbare Infrastruktur
• Echtzeitdaten zu jedem Land der Welt, zusammengestellt in einem höhlenartigen Datensatz, der alle paar Stunden aktualisiert wird
• Großzügig aufgeteilte Abonnements zu wettbewerbsfähigen Preisen; plus ein konkurrenzloses monatliches Kontingent von 10.000 Anfragen für kostenlose Benutzer
• Integrationsunterstützung für alle wichtigen Programmiersprachen
• Umfassende, einfach zu lesende Dokumentation mit Codefragmenten
• Ein erstklassiges Kundenzufriedenheitsteam mit Erfahrung für Kunden wie Zendesk, Slack, LinkedIn, Lyft, Apple und Amazon

Positionstack hat sicherlich seinen Stammbaum in Schach, aber falls Sie nicht von einer Handvoll Stichpunkten überzeugt sind, lassen Sie uns einen tiefen Einblick in die tatsächliche Verwendung der API geben.

3-Schritt-Kurzanleitung von Positionstack

Wenn Sie Zeit auf ihrer Website verbringen, werden Sie feststellen, dass Positionstack die Benutzerfreundlichkeit als Hauptverkaufsargument für die API betont. Während des Anmeldevorgangs werden Sie sofort feststellen, dass dies ganz richtig ist. Das erste, was Sie nach der Eingabe Ihrer Kontoanmeldeinformationen sehen, ist eine kurze Roadmap, wie Sie mit Positionstack in drei einfachen Schritten arbeiten können. Lass uns mal sehen:

1. Legen Sie Ihren API-Zugriffsschlüssel fest - Standardmäßig erhalten Sie einen Zugriffsschlüssel, der sofort einsatzbereit ist. Sie können dies jedoch später problemlos nach Bedarf zurücksetzen.
2. Wählen Sie API-Endpunkte - Im nächsten Abschnitt werden API-Endpunkte ausführlicher behandelt. Im Moment verstehen wir jedoch nur, dass sich dieser Schritt auf die Konfiguration des Datentyps bezieht, der zurückgegeben wird, wenn Ihre App eine Anforderung an Positionstack sendet. Hier sehen Sie zuerst die Basis-URL, auf die Sie Ihre Anforderungen ausrichten. Sie wird jedoch auch in der Dokumentation angezeigt. Schließlich sehen wir eine Beispiel-API-Anfrage, die nur aus wenigen einfachen Codezeilen besteht.
3. Anwendungsintegration - Der letzte Schritt bezieht sich auf die endgültige Integration der Positionstack-API in Ihre Anwendung. Es gibt eine Menge über diesen Prozess zu wissen, und das meiste davon wird in der Dokumentation behandelt. Das Wichtigste dabei ist: Das Support-Team von Positionstack hat Ihren Rücken und bietet so viel oder so wenig Hilfe, wie Sie benötigen, um die API zu konfigurieren und in Ihre App zu integrieren.

Ziemlich einfach, oder? APIs mögen Leuten ohne umfassende IT-Kenntnisse zunächst einschüchternd erscheinen. Auf Anhieb tröstet Sie Positionstack mit dem Wissen, dass es nicht nur einfach ist, sondern Ihnen auch bei der unglaublichen Dokumentation ihres intelligenten Designs hilft. Es hilft ihnen, ein leidenschaftliches Expertenteam zur Verfügung zu haben, das bereit ist, Ihnen ebenfalls zu helfen.

Ihr Positionstack-Dashboard

Positionstack verdoppelt seinen Kernwert der Benutzerfreundlichkeit und bietet ein optimiertes, übersichtliches Dashboard, über das Sie auf alles zugreifen können, was Sie über Ihre API wissen müssen. Werfen wir einen Blick auf die Optionen in der Seitenleiste:

• Instrumententafel - Hier finden Sie Benachrichtigungen (die Sie normalerweise benachrichtigen, wenn Sie bestimmte Nutzungsschwellenwerte überschreiten) und Links zur 3-Schritt-Kurzanleitung und zur Dokumentationsseite. Es gibt auch eine Übersicht über Ihren API-Schlüssel, Ihr aktuelles Abonnement, Kontodetails und die Zahlungsmethode.
• Upgrade / Abonnement - Sie können Ihr Abonnement für eine dieser beiden Optionen ändern. Ein Upgrade ist jederzeit möglich. Wenn Sie jedoch zwischen einem Monats- oder Jahresplan in eine der beiden Richtungen wechseln möchten, müssen Sie zuerst ein Downgrade auf ein kostenloses Konto durchführen und dann die gewünschte Option auswählen. Der Positionstack-Support hilft Ihnen gerne weiter, wenn Sie dabei Hilfe benötigen.
• Konto / Zahlung - Diese sind selbsterklärend; Auf beiden Registerkarten können Sie Ihre Anmeldeinformationen jederzeit aktualisieren. Es muss gesagt werden, dass wir es zu schätzen wissen, dass sie diese grundlegenden Steuerelemente nicht in einer überarbeiteten, auffälligen Oberfläche vergraben. WYSIWYG.
• API-Nutzung - Wahrscheinlich die Registerkarte, die Sie am häufigsten erneut aufrufen. Hier finden Sie, wie viel von Ihrem monatlichen Anforderungskontingent Sie bisher verbraucht haben. Es gibt auch einen praktischen Abschnitt, in dem Ihre Nutzungsstatistiken im Zeitverlauf angezeigt werden, sodass Sie Ihre Strategie entsprechend anpassen können.

API-Dokumentation

Jetzt kommen wir zum Herzen und zur Seele von Positionstacks Angebot: dem API-Dokumentation. Betrachten Sie diese Seite als Ihr Benutzerhandbuch, in dem die einzelnen API-Endpunkte, ihre Parameter und die Art der zurückgegebenen Informationen aufgeführt sind.

Diese Seite ist in fünf verschiedene Abschnitte unterteilt. Wir werden die einzelnen Schritte durchgehen und einige Zeit und Worte investieren, um Ihnen einen Kontext zu bieten, in dem Sie besser verstehen, was Sie finden werden.

Anfangen

Hier finden Sie Basisfunktionen Dies gilt für jede Anfrage, die Sie mit Positionstack stellen. Diese sind:

• API-Schlüssel - Ihr API-Schlüssel ähnelt einem digitalen Pass, mit dem Sie auf den Datensatz von Positionstack zugreifen. Ohne sie ist die API für Sie nutzlos. Wenn Sie glauben, dass es kompromittiert wurde, können Sie Ihren alten Schlüssel leicht gegen einen neuen austauschen.
• Verschlüsselung - Die 256-Bit-SSL-Verschlüsselung wird im gesamten Internet verwendet und ist aus gutem Grund der Industriestandard für Sicherheit. Sie benötigen zwar einen Basisplan oder besser, um die Kommunikation Ihrer App mit den Servern von Positionstack zu verschlüsseln, aber die Investition allein lohnt sich. Um die Verschlüsselung hervorzurufen, ändern Sie einfach HTTP in der API-Basis-URL in HTTPS. Einfach!
• JSON-Rückrufe - Wir werden nicht auf zu viele technische Details eingehen, wie dies funktioniert. Wenn Ihre API-Anforderungen jedoch durch Richtlinien mit demselben Ursprung blockiert werden, verwenden Sie JSON-Rückrufe, um eine Problemumgehung zu bewirken. Im Wesentlichen fordern Sie Daten von einem externen Skript an, das nicht mit domänenübergreifenden Problemen konfrontiert ist.
• API-Fehler - Wie bei allem anderen treten bei Ihren API-Anforderungen manchmal Fehler auf. Positionstack versteht dies und hat in seine App eine Funktion zur Fehlerberichterstattung integriert, mit deren Hilfe Sie feststellen können, was schief gelaufen ist. API-Anforderungsfehler geben automatisch ein Fehlerobjekt im JSON-Format sowie Code-, Nachrichten- und Kontext-Unterobjekte zurück, um den Kontext für den Fehler bereitzustellen.

API-Endpunkte

Dieser Abschnitt dokumentiert die Fleisch- und Kartoffelfunktionalität von Positionstack, dh die Vorwärts- und Rückwärts-Geokodierung. Wenn Sie sich nicht zu 100% sicher sind, was der Unterschied ist, stellen Sie sich Geokodierung als eine Einbahnstraße vor, in die Sie übersetzen können Orte und Adressen, die in einfachem Englisch zu Standortdaten wie Koordinaten und IP-Adressen geschrieben wurden, und umgekehrt.

Sie würden also die Vorwärts-Geokodierung verwenden, um den Standort des Eiffelturms in Koordinaten umzuwandeln. In ähnlicher Weise können Sie die einer IP-Adresse zugeordnete Straßenadresse mithilfe der umgekehrten Geokodierung ermitteln. Immerhin ziemlich einfach!

Vorwärts- / Rückwärts-Geokodierungsanforderungen

Um eine grundlegende Anforderung für eine der beiden Arten der Geokodierung zu stellen, müssen Sie den entsprechenden Endpunkt anhängen (/forward oder /reverse) zur Basis-URL der API. Als Nächstes geben Sie Ihren Zugangsschlüssel ein und erstellen dann einen Abfrage entweder mit einer einfach-englischen Standortadresse oder den entsprechenden Standortdaten - und voila! Es wird ungefähr so ​​aussehen:

https://api.positionstack.com/v1/forward? access_key = YOUR_ACCESS_KEY & query = 1600 Pennsylvania Ave NW, Washington DC. 

oder

https://api.positionstack.com/v1/reverse? access_key = YOUR_ACCESS_KEY & query = 40.7638435, -73.9729691. 

Natürlich enthält der Datensatz von Positionstack viel, viel mehr als nur Adressen und Koordinaten. Sie können diese anderen Kategorisierungen mithilfe verschiedener Parameter analysieren. Hier ist ein Beispiel dafür, was a Vorwärts-Geokodierung Anfrage, die das Weiße Haus abfragt, sieht aus wie:

{"Daten": {"Ergebnisse": [{"Breitengrad": 38.897675, "Längengrad": -77.036547, "Etikett": "1600 Pennsylvania Avenue NW, Washington, DC, USA", "Name": "1600 Pennsylvania Avenue NW "," Typ ":" Adresse "," Nummer ":" 1600 "," Straße ":" Pennsylvania Avenue NW "," Postleitzahl ":" 20500 "," Vertrauen ": 1," Region ":" Kreis of Columbia "," region_code ":" DC "," administrative_area ": null," Nachbarschaft ":" White House Grounds "," country ":" United States "," country_code ":" US ", "map_url": " http://map.positionstack.com/38.897675,-77.036547" } ] } }

Interessanterweise, wenn Sie eine tun würden umgekehrte Geokodierung Wenn Sie die ungefähren Koordinaten des Weißen Hauses verwenden, sehen die zurückgegebenen Ergebnisse fast identisch aus, außer Sie sehen auch den Unterschied in Entfernung zwischen Ihren Koordinaten und den offiziellen Koordinaten des Weißen Hauses, wie sie im Datensatz von Positionstack erscheinen.

Der Grund für diese Ähnlichkeit besteht darin, dass beide Endpunkte dasselbe Array von GET-Parametern verwenden und somit (fast) dieselben Antwortobjekte zurückgeben können. Das bedeutet, dass Sie unabhängig von den Startdaten, die Sie benötigen, im Gegenzug eine vollständige Ergänzung der Standortdaten erhalten können. (Es ist möglich, diese Ergebnisse mithilfe der APIs einzugrenzen Felder Parameter, aber darauf werden wir später noch eingehen.)

Hinweis: Auf der Dokumentationsseite von Positionstack werden alle Parameter und Antwortobjekte ausführlich beschrieben. Schauen Sie sich diese also unbedingt an!

Stapelanfragen

Die letzte wichtige Überschrift in dieser Dokumentationseinstellung behandelt Batch-Anfragen. Sie müssen lediglich das aufrufen Stapel Parameter, dann verschachteln mehrere Abfrage Instanzen (zusammen mit Ihren gewünschten Parametern) darunter in einer einzelnen Anforderung, und die Positionstack-API kümmert sich um den Rest. Es ist ganz einfach und sieht so aus:

{"batch": [{"query": "Main Street", "country": "US", "region": "Minnesota"}, {"query": "Main Street", "country": "US", "region": "Illinois"}, {"query": "Main Street", "country": "US", "region": "Missouri"} ] }

Erweiterte Daten

Zusätzlich zu den grundlegenden Standortparametern können Sie Ihre API-Anforderungen weiter anpassen, um mehr zurückzugeben erweiterte Daten. Diese beinhalten:

• Einbettbare Karten - Gibt ein map_url-Objekt zurück, das mit Ihrem Geokodierungsergebnis verknüpft ist und mit dem Sie eine attraktive visuelle Kartendarstellung auf Ihrer Website oder App erstellen können.
• Ländermodul - Im Gegensatz zu anderen Parametern, die bis zu einigen Antwortobjekten zurückgeben, country_module gibt eine unglaubliche Reihe von Daten über Ihr abgefragtes Land zurück. Es sind nicht nur Koordinaten und Adressen. Es ist die Hauptstadt, die Flagge, der offizielle Name, der Status als Binnenstaat (oder nicht), die verwendeten Währungen, die gesprochenen Sprachen, die Rufnummern und vieles mehr.
• Sonnenmodul - In der Dokumentation von Positionstack wird dies humorvoll als "astrologische" Daten beschrieben. Mit diesem Parameter erhalten Sie kein Horoskop, aber Sie sehen Daten darüber, wann die Sonne aufgeht und untergeht, je nach astronomischer, ziviler und nautischer Chronologie.
• Zeitzonenmodul - Anhängen timezone_module um den GMT-Offset eines Standorts entweder in Sekunden oder als Zeichenfolge in natürlicher Sprache zurückzugeben.
• Begrenzungsrahmenmodul - Wenn ein einzelnes x / y-Koordinatenpaar für Ihre Aufgabe nicht geeignet ist, versuchen Sie es mit einem Begrenzungsrahmen, der einen Bereich mit minimalen und maximalen Werten für Längen- und Breitengrad einschließt.

Zusätzliche Optionen

Die Positionstack-API hat eine Menge Daten, die Sie abwerfen können, aber zum Glück liefert sie Ihnen diese zusätzliche Werkzeuge um diesen Informationsschatz zu verwalten.

• Geben Sie Antwortfelder an - Wir haben ausführlich erläutert, wie viele Daten Positionstack zurückgeben kann. Beachten Sie jedoch, dass all diese Daten kostenpflichtig sind. Wenn Sie Ihre monatlichen Anfragen begrenzen möchten, können Sie dies mit dem tun Felder Anhängen fields = results.flagDies führt beispielsweise dazu, dass die API nur das Flag Ihres abgefragten Landes ausgibt. Sie können aufrufen Felder so oft Sie müssen, um den gewünschten Datensatz zu erhalten.
• Geben Sie das Ausgabeformat an - Kostenlose Abonnenten sind für ihre zurückgegebenen Geokodierungsergebnisse auf das JSON-Format beschränkt. Zahlende Kunden können jedoch anhängen Ausgabe auf ihre Anforderungen, JSON, XML oder GeoJSON nach Bedarf anzugeben.

Codebeispiele

Wenn Positionstack sagt, dass sie hier sind, um Ihnen zu helfen, meinen sie es ernst. Wir haben bereits gesehen, wie gründlich ihre Dokumentation ist, aber sie runden sie mit praktischen Informationen ab Codebeispiele in allen Sprachen, die ihre API unterstützt. Wir werden diesen Code hier nicht kopieren / einfügen, aber zum schnellen Nachschlagen sind diese Sprachen:

• Python
• Nodejs
• jQuery
• Gehen
• Rubin

Beweis und Leistung

An dieser Stelle sollte klar sein, dass Positionstack in der Lage ist, ziemlich viel zu tun. Aber, wie gut macht es diese Dinge?

Betrachten wir zunächst einen Kontext. Positionstack ist einer von über 20 API-Mikrodiensten im Cloud-basierten Ökosystem von Apilayer. Zusammen bedienen diese APIs über eine Million B2B-Clients von Startups bis hin zu Unternehmen. Zu ihren bekanntesten Kunden zählen Amazon, Apple, Slack, LinkedIn und viele weitere bekannte Namen. Offensichtlich verfügen sie über eine robuste Infrastruktur, um diese Nachfrage zu bewältigen.

Positionstack wird seinem Stammbaum mit einer unglaublichen Verfügbarkeit von 100% im gesamten Jahr 2020 zum Zeitpunkt des Schreibens gerecht. Dies ist umso beeindruckender, wenn Sie die API betrachten routinemäßig verarbeitet mehr als eine Milliarde Geocode-Lookups pro Tag und Wal-Client, ganz zu schweigen von der schwindelerregenden Anzahl gleichzeitiger Anfragen, die von ihren SMB-Kunden kommen. Darüber hinaus erhalten diese Anforderungen in der Regel Antworten zwischen 10 und 100 ms.

In unserem Buch ist dies ein technologisches Wunder, insbesondere angesichts des aggressiven Preises dieses SaaS-Angebots.

Und es ist nicht nur die rohe Kraft, die Positionstack so attraktiv macht. Ihr Datensatz ist wirklich hoch entwickelt und basiert auf zuverlässigen Namen wie Nominatim, GeoNames, Pelias und OpenStreetMap. Positionstack überprüft, filtert und kombiniert diese Datenfülle mehrmals täglich, um regelmäßige Aktualisierungen zu ermöglichen über intelligente Algorithmen, die sicherstellen, dass Sie immer hochpräzise Standortdaten haben, überall auf der Welt und in der Realität Zeit.

Wir hassen es, unser endgültiges Urteil zu verderben, aber wenn Sie nach einer robusten, skalierbaren Geokodierungslösung suchen, muss der Lebenslauf von Positionstack genauer betrachtet werden.

Preisgestaltung

Apilayer wollte eine kostengünstige Alternative zu hochpreisiger Geokodierungssoftware auf Unternehmensebene bieten, und diesbezüglich ist es ihnen gelungen.

Positionstack kommt in fünf Preisgestaltung Stufen und unterstützt monatliche Abrechnungen oder Jahresabonnements mit einem Rabatt von 20%. Diese Ebenen sind:

• Kostenlos - Für den persönlichen Gebrauch bewertet, erhalten Sie mit 25.000 monatlichen Anfragen nach Vorwärts- und Rückwärts-Geokodierung, die im JSON-Format ausgegeben werden, immer noch ein gutes Stück Kilometerleistung. Sie erhalten nicht viele erweiterte Funktionen oder Kundenunterstützung, aber wir haben Ihnen bereits gezeigt, welche wertvolle Ressource die Dokumentationsseite darstellt. Diese Stufe ist kostenlos und unverbindlich. Sie müssen nicht einmal Ihre Kreditkartendaten angeben, um loszulegen.
• Basic - Das kommerzielle Einstiegspaket. Basisabonnenten vervierfachen ihr monatliches Kontingent auf 100.000 Geokodierungsanforderungen und erhalten Zugriff auf erweiterte Funktionen wie HTTPS-Verschlüsselung, mehrere Ausgabeoptionen (JSON, XML, GeoJSON), einbettbare Karten, mehrere Sprachen, und mehr. Holen Sie sich eine kommerzielle Positionstack-Lizenz für nur 9,99 USD pro Monat.
• Fachmann - Das beliebteste Angebot von Positionstack, die Professional-Stufe, bietet eine Verzehnfachung der Geokodierungsanforderungen - bis zu 1.000.000 pro Monat. Alle Extras aus der Basisstufe sind vorhanden und einige, insbesondere Batch-Anfragen für Hochleistungsanwendungen. Diese Stufe kostet 49,99 US-Dollar pro Monat.
• Geschäft - Um die Leistung auf Unternehmensebene zu steigern, erhöht die Business-Ebene das monatliche Kontingent auf satte 3.000.000 Anfragen. Erneut ist jede erweiterte Funktion vollständig verfügbar und wird vom leidenschaftlichen Kundensupport-Team von Positionstack unterstützt, damit Sie sie optimal nutzen können. 99,99 USD pro Monat.
• Unternehmen - Dies ist die Stufe, in der Standardangebote aus dem Fenster gehen und der Kunde König ist. Sie haben präzise Anforderungen, die kundenspezifische Lösungen erfordern, und Positionstack ist bereit, Ihre Ziele zu erreichen. Sie bestimmen Ihre monatlichen Volumenanforderungen, auch (insbesondere) wenn sie variabel sind. Benötigen Sie mehr Leistung von der API? Wenden Sie sich an kundenspezifische Lösungen. Wenden Sie sich an Positionstack, um ein Angebot zu erhalten.

Urteil

Positionstack macht genau das, was es sich vorgenommen hat: die Geokodierung auf Unternehmensebene von Preispunkten, die sonst nicht im Budget sind, auf die meisten KMUs zu reduzieren, ohne die Leistung zu beeinträchtigen. Ihre API ist gut dokumentiert und einfach zu verwenden, bietet jedoch eine robuste Integration in alle wichtigen Programmiersprachen für maximalen Nutzen. Die Anzahl der Anfragen, die Positionstack routinemäßig verarbeitet, ist atemberaubend, während der Datensatz intelligent verwaltet wird, um eine wirklich globale Reichweite bei der Echtzeit-Geokodierung zu erzielen. Wenn Sie auf dem Markt für diese Art von Produkten sind, schlafen Sie nicht auf Positionstack.

Welche Art von Integration haben Sie geplant? Wie werden Sie die Geokodierung in Ihrem Unternehmen nutzen? Haben Sie Fragen oder Kommentare zu Positionstack? Hinterlassen Sie uns eine Nachricht in den Kommentaren unten.