Positionstack APIを使用してエンタープライズレベルのジオコーディングを無料で入手（レビュー）

ジオコーディングから価値を得るのにGoogleマップである必要はありません。また、Positionstackのおかげで、BigGの技術予算も必要ありません。今日は、Positionstackの堅牢なAPIを確認します。これは、エンタープライズレベルのフォワードおよびリバースジオコーディングを非常に手頃な価格で使いやすくすることを目的としています。

ポジションスタック101

では、なぜあなたは上の2,000+単語のレビュー読んで気にする必要がありPositionstackを、そして何を得るために立っていますか？答えはキュートに聞こえるが、それは正確です：世界全体。

世界地図上にいくつの場所があるかを少し考えてみてください。今、あなたのビジネスがそれらの場所について知る必要があるメタデータのすべての部分であなたの頭の中でその数を掛けます。それがPositionstackが提供するものであり、それからいくつかあります。

Positionstackに関するいくつかの簡単な統計を見てみましょう：

• 毎日、1時間ごとに処理される実際の数十億のジオコーディングルックアップリクエスト。100％の稼働時間と<100ms = "" response = "">
• クラウドベースの高度にスケーラブルなインフラストラクチャ
• 数時間ごとに更新される海綿状のデータセットにコンパイルされた、世界のすべての国のリアルタイムデータ
• 寛大に配分された、競争力のある価格のサブスクリプションプラン。さらに、無料ユーザー向けの比類のない10,000リクエストの月間割り当て
• すべての主要なプログラミング言語の統合サポート
• コードスニペットを備えた、包括的で読みやすいドキュメント
• Zendesk、Slack、LinkedIn、Lyft、Apple、Amazonなどのクライアントにサービスを提供した経験を持つ世界クラスの顧客満足度チーム

Positionstackは確かにその血統をチェックしていますが、いくつかの箇条書きに納得できない場合は、実際にAPIを使用するのがどのようなものかを深く掘り下げてみましょう。

Positionstackの3ステップクイックスタートガイド

彼らのウェブサイトで時間を過ごすと、PositionstackがAPIの主なセールスポイントとして使いやすさを本当に強調していることがわかります。サインアッププロセス中に、それが非常に真実であることがすぐにわかります。実際、アカウントのクレデンシャルを入力した後に最初に表示されるのは、3つの簡単なステップでPositionstackを起動して実行するために必要なものの簡単なロードマップです。見てみましょう：

1. APIアクセスキーを設定する–デフォルトでは、箱から出してすぐに使用できるアクセスキーが渡されます。ただし、必要に応じて、これを簡単にリセットできます。
2. APIエンドポイントの選択– APIエンドポイントについては次のセクションで詳しく説明しますが、今のところ、この手順は、アプリがPositionstackにリクエストを送信したときに返されるデータの種類を構成することを指していることを理解してください。ここに、リクエストのターゲットとなるベースURLが最初に表示されますが、ドキュメントにも表示されます。最後に、数行の簡単なコードで構成されるサンプルAPIリクエストが表示されます。
3. アプリケーション統合–最後のステップは、PositionstackのAPIをアプリケーションに最終的に統合することです。このプロセスについて知っておくべきことはかなりあり、そのほとんどはドキュメントで説明されています。ここで重要なのは、Positionstackのサポートチームがあなたの背中を持っており、APIを構成してアプリに統合するために必要な支援を提供します。

とても簡単ですよね？APIは、最初はITに関する広範な知識がない人にとっては、威圧的に見えるかもしれません。しかし、すぐに、Positionstackは、簡単であるだけでなく、スマートなデザインの素晴らしいドキュメントを作成するのに役立つという知識であなたを慰めます。それは彼らがあなたを助ける準備ができている専門家の情熱的なチームを持つのを助けます。

ポジションスタックダッシュボード

使いやすさというコアバリューを倍増させたPositionstackは、APIについて知る必要のあるすべてのものにアクセスできる、合理化された整理されたダッシュボードを提供します。サイドバーのオプションを見てみましょう。

• ダッシュボード–ここには通知（通常、特定の使用量のしきい値を超えると警告が表示されます）があり、3ステップのクイックスタートガイドとそのドキュメントページの両方にリンクしています。APIキー、現在のサブスクリプション、アカウントの詳細、および支払い方法の概要もあります。
• アップグレード/サブスクリプション–これら2つのオプションのいずれかでサブスクリプションを変更できます。いつでもアップグレードできますが、いずれかの方向で月額プランと年額プランを切り替える場合は、最初に無料アカウントにダウングレードしてから、目的のオプションを選択する必要があります。あなたがこれをするのに助けが必要な場合、Positionstackサポートは喜んであなたを助けます。
• アカウント/支払い–これらは自明です。どちらのタブでも、いつでも資格情報を更新できます。これらの基本的なコントロールが、過剰に設計された派手なインターフェイスに埋め込まれていないことを理解していると言わなければなりません。WYSIWYG。
• APIの使用法–最も頻繁に再訪する可能性が高いタブです。ここでは、これまでに消費した1か月のリクエストクォータの量を確認できます。時間の経過に伴う使用統計を表示する便利なセクションもあるので、それに応じて戦略を調整できます。

APIドキュメント

ここで、Positionstackの提供の核心であるAPIドキュメントに到達します。このページを、各APIエンドポイント、それらのパラメーター、およびそれらが返す情報の種類について詳しく説明している、頼りになるユーザーマニュアルと考えてください。

このページは5つのセクションに分かれています。それぞれについて説明し、時間と言い回しを使って、見つけたものをよりよく理解するためのコンテキストを提供します。

入門

ここでは、Positionstackで行うすべてのリクエストに適用される基本的な機能を紹介します。これらは：

• APIキー– APIキーは、Positionstackのデータセットにアクセスするために使用するデジタルパスポートのようなものです。それがなければ、APIは役に立ちません。侵害されたと思われる場合は、古いキーを簡単にローテーションして新しいキーに変えることができます。
• 暗号化– 256ビットSSL暗号化はインターネット全体で使用されており、正当な理由からセキュリティの業界標準です。アプリとPositionstackのサーバーとの通信を暗号化するには、基本プラン以上が必要ですが、それだけで投資する価値は十分にあります。暗号化を呼び出すには、APIベースURLでHTTPをHTTPSに変更するだけです。単純！
• JSONコールバック–これがどのように機能するかについての技術的な詳細についてはあまり詳しく説明しませんが、APIリクエストが同一生成元ポリシーによって妨害されている場合は、JSONコールバックを使用して回避策に影響を与えます。基本的に、クロスドメインの問題に悩まされることのない外部スクリプトからデータを要求します。
• APIエラー–他の場合と同様に、APIリクエストでエラーが発生することがあります。Positionstackはこれを理解し、問題を特定するのに役立つエラー報告機能をアプリに組み込んでいます。APIリクエストが失敗すると、JSON形式のエラーオブジェクトに加えて、エラーのコンテキストを提供するコード、メッセージ、コンテキストサブオブジェクトが自動的に返されます。

APIエンドポイント

このセクションでは、Positionstackの肉とジャガイモの機能、つまり順方向と逆方向のジオコーディングについて説明します。違いが100％わからない場合は、ジオコーディングを、平易な英語で書かれた場所と住所を座標やIPアドレスなどの位置データに変換したり、その逆を行ったりできる双方向の道路と考えてください。

したがって、前方ジオコーディングを使用して、エッフェル塔の位置を座標に変換します。同様に、逆ジオコーディングを使用すると、IPアドレスに関連付けられている番地を見つけることができます。結局のところ、非常に簡単です！

フォワード/リバースジオコーディングリクエスト

いずれかのタイプのジオコーディングの基本的なリクエストを行うには、適切なエンドポイント（/ forward または/ reverse）をAPIのベースURLに追加する必要があります。次に、アクセスキーを入力し、平易な英語の場所の住所または対応する場所のデータを使用してクエリを実行します。これで、出来上がりです。次のようになります。

https://api.positionstack.com/v1/forward
    ？access_key = YOUR_ACCESS_KEY
    ＆query = 1600 Pennsylvania Ave NW、Washington DC

また

https://api.positionstack.com/v1/reverse
    ？access_key = YOUR_ACCESS_KEY
    ＆クエリ= 40.7638435、-73.9729691

もちろん、Positionstackのデータセットには、住所や座標だけでなく、はるかに多くのものが含まれています。さまざまなパラメーターを使用して、これらの他の分類を解析できます。ホワイトハウスにクエリを実行するフォワードジオコーディングリクエストの例を次に示します。

{{
   "データ"： {
      "結果"： [
         {{
            「緯度」：38.897675、
            「経度」：-77.036547、
            "ラベル"： "1600 Pennsylvania Avenue NW、Washington、DC、USA"、
            "名前"： "1600ペンシルバニアアベニュー北西"、
            "タイプ"： "アドレス"、
            「番号」：「1600」、
            「通り」：「ペンシルバニアアベニュー北西」、
            "postal_code"： "20500"、
            「自信」：1、
            「地域」：「コロンビア特別区」、
            "region_code"： "DC"、
            "administrative_area"：null、
            「近所」：「ホワイトハウスの敷地」、
            「国」：「米国」、
            "country_code"： "US"、
            "map_url"： "https://map.positionstack.com/38.897675,-77.036547"
         }
      ]
   }
}

興味深いことに、ホワイトハウスのおおよその座標を使用して逆ジオコーディングリクエストを実行した場合、Positionstackに表示されるように、座標とホワイトハウスの公式座​​標との距離の違いも表示されることを除いて、返される結果はほぼ同じになります。データセット。

この類似性の理由は、両方のエンドポイントがGETパラメーターの同じ配列を利用するため、（ほぼ）同じ応答オブジェクトを返すことができるためです。つまり、どの開始データを使用する必要がある場合でも、代わりに位置データの完全な補完を取得できます。（APIのfields パラメーターを使用してこれらの結果を絞り込むことは可能ですが、これについては後で詳しく説明します。）

注：Positionstackのドキュメントページには、各パラメーターと応答オブジェクトの詳細が記載されているため、必ず確認してください。

バッチリクエスト

このドキュメント設定の最後の主要な見出しは、バッチリクエストを扱っています。バッチ パラメータを呼び出してから、1つのリクエストで複数のクエリインスタンスを（必要なパラメータとともに）ネストするだけで、残りはPositionstackのAPIが処理します。とてもシンプルで、次のようになります。

{{
   "バッチ"：[
      {{
         "クエリ"： "メインストリート"、
         「国」：「米国」、
         「地域」：「ミネソタ」
      }、
      {{
         "クエリ"： "メインストリート"、
         「国」：「米国」、
         「地域」：「イリノイ」
      }、
      {{
         "クエリ"： "メインストリート"、
         「国」：「米国」、
         「地域」：「ミズーリ」
      }
   ]
}

高度なデータ

基本的な位置パラメータに加えて、APIリクエストをさらに調整して、より高度なデータを返すことができます。これらには以下が含まれます：

• 埋め込み可能なマップ–ジオコーディング結果にリンクされたmap_urlオブジェクトを返します。これを使用して、Webサイトまたはアプリで魅力的な視覚的なマップ表現を作成できます。
• 国モジュール–いくつかの応答オブジェクトを返す他のパラメーターとは異なり、country_moduleは、照会された国に関する信じられないほどのデータの配列を返します。座標や住所だけではありません。これは、首都、旗、正式名称、内陸国（または内陸国ではない）の国としてのステータス、使用される通貨、話される言語、通話コードなどです。
• Sun Module –ユーモラスなことに、Positionstackのドキュメントでは、これを「占星術」データとして説明しています。このパラメーターを使用して星占いを取得することはできませんが、天文学、民間、および航海の年表に従って、太陽がいつ昇り、沈むかについてのデータが表示されます。
• タイムゾーンモジュール– timezone_moduleを追加して、場所のGMTオフセットを秒単位または自然言語文字列として返します。
• バウンディングボックスモジュール–単一のx / y座標ペアがタスクに適していない場合は、経度と緯度の最小値と最大値で領域を囲むバウンディングボックスを試してください。

追加オプション

Positionstack APIには大量のデータがありますが、幸いなことに、この大量の情報を管理するための追加のツールが提供されています。

• 応答フィールドの指定– Positionstackが返すことができるデータの量について詳しく説明しましたが、そのすべてのデータにはコストがかかることに注意してください。毎月のリクエストを制限したい場合は、フィールドAppending fields = results.flagを使用してこれを行うことができます。たとえば、APIはクエリされた国のフラグのみを出力します。必要な特定のデータセットを取得するために、必要な回数だけフィールドを呼び出すことができます。
• 出力形式の指定–無料のサブスクライバーは、返されるジオコーディング結果のJSON形式に制限されます。ただし、有料の顧客は、必要に応じてJSON、XML、またはGeoJSONを指定するために、リクエストに出力を追加できます。 

コード例 

Positionstackがあなたを助けるためにここにいると言うとき、彼らはそれを意味します。ドキュメントがどれほど徹底的であるかはすでに見てきましたが、APIがサポートするすべての言語の便利なコード例で締めくくっています。ここではそのコードをコピーして貼り付けるつもりはありませんが、すぐに参照できるように、これらの言語は次のとおりです。

• Python
• Nodejs
• jQuery
• 行け
• ルビー

証明とパフォーマンス

この時点で、Positionstackが非常に多くのことを実行できることは明らかです。しかし、それはこれらのことをどれだけうまくやっていますか？

まず、いくつかのコンテキストを考えてみましょう。Positionstackは、Apilayerのクラウドベースのエコシステムにある20以上のAPIマイクロサービスの1つです。これらのAPIを組み合わせることで、スタートアップからエンタープライズに至るまで、100万を超えるB2Bクライアントにサービスを提供します。彼らの最も注目すべき顧客には、Amazon、Apple、Slack、LinkedIn、その他多くの世帯名が含まれます。明らかに、この規模の需要を処理するための堅牢なインフラストラクチャがいくつかあります。

それ自体のメリットとして、Positionstackはその血統に沿っており、執筆時点で2020年を通して信じられないほどの100％の稼働時間を実現しています。これは、APIがクジラのクライアントごとに1日あたり10億を超えるジオコードルックアップを定期的に処理することを考えると、さらに印象的です。安定したSMB顧客からの同時リクエストの目まぐるしい配列は言うまでもありません。さらに、これらの要求は通常、10〜100ミリ秒の応答を収集します。

私たちの本では、特にこのSaaS製品の価格がいかに高額であるかを考えると、これは技術的な驚異のようなものです。

そして、Positionstackを魅力的なものにしているのは生の力だけではありません。彼らのデータセットは本当に洗練されており、Nominatim、GeoNames、Pelias、OpenStreetMapなどの信頼できる名前から供給されています。Positionstackは、この豊富なデータを1日に複数回クロスチェック、フィルタリング、再結合し、スマートアルゴリズムを介して定期的な更新をプッシュすることで、世界中のどこにいてもリアルタイムで常に高精度の位置データを取得できるようにします。

最終的な判断を台無しにするのは嫌いですが、堅牢でスケーラブルなジオコーディングソリューションを探している場合は、Positionstackの履歴書で詳しく調べる必要があります。

価格設定 

Apilayerは、非常に高価なエンタープライズレベルのジオコーディングソフトウェアに代わる手頃な価格のソフトウェアの提供に着手し、その目的に向けて成功しました。

Positionstackには5つの価格階層があり、月額請求または年額サブスクリプションを20％割引でサポートします。それらの層は次のとおりです。

• 無料–個人使用の評価を受けていますが、JSON形式で出力された順方向および逆方向のジオコーディングの月間25,000件のリクエストで、まだかなりのマイレージを獲得しています。高度な機能やカスタマーサポートはあまり受けられませんが、ドキュメントページの貴重なリソースについてはすでに説明しました。このティアは無料で、義務もありません。開始するためにクレジットカードの詳細を提供する必要はありません。
• 基本–エントリーレベルの商用パッケージ。基本的なサブスクライバーは、月間割り当てを4倍にして100,000のジオコーディング要求に加え、HTTPS暗号化、複数の出力オプション（JSON、XML、GeoJSON）、埋め込み可能なマップ、複数の言語などの高度な機能にアクセスできます。月額わずか9.99ドルで商用のPositionstackライセンスを取得します。
• Professional – Positionstackで最も人気のある製品であるProfessional層では、ジオコーディングリクエストが10倍に増加し、1か月あたり最大1,000,000になります。基本層からのすべての機能が存在し、その後、特にヘビーデューティーアプリケーションのバッチ要求を含むいくつかの機能が存在します。この層は月額$ 49.99でクロックインします。
• ビジネス–エンタープライズ規模のパフォーマンスに移行すると、ビジネス層は1か月の割り当てをなんと3,000,000件のリクエストに膨らませます。繰り返しになりますが、Positionstackの情熱的なカスタマーサポートチームが支援するすべての高度な機能が完全に利用可能であり、それらを最大限に活用するのに役立ちます。月額$ 99.99。
• エンタープライズ–これは、標準のオファーがウィンドウの外に出て、顧客が王様である層です。カスタムソリューションを必要とする正確なニーズがあり、Positionstackは目標を達成する準備ができています。（特に）変動する場合でも、毎月のボリュームリクエストを指示します。APIからより多くの馬力が必要ですか？カスタムビルドソリューションのサポートに連絡してください。見積もりについては、Positionstackにお問い合わせください。

評決

Positionstackは、当初の目的を正確に実行します。パフォーマンスを犠牲にすることなく、エンタープライズレベルのジオコーディングを価格から予算外のほとんどのSMBに引き下げます。それらのAPIは十分に文書化されており、使いやすいですが、最大限の有用性を実現するために、すべての主要なプログラミング言語間で堅牢に統合されています。Positionstackが日常的に処理するリクエストの数は驚異的ですが、データセットはリアルタイムのジオコーディングで真にグローバルなリーチを実現するためにスマートに維持されています。このタイプの製品の市場にいる場合は、Positionstackで眠らないでください。

どのような統合を計画していますか？ビジネスでジオコーディングをどのように活用しますか？Positionstackについて質問やコメントがありますか？以下のコメントにメモを残してください。