Recebemos frequentemente pedidos para usar funcionalidades de geocodificação (obter latitude e longitude a partir de um endereço) e geocodificação reversa (obter o endereço a partir da latitude e longitude) no lado do servidor.ArcGIS Além das aplicações de mapeamento no lado do cliente, o API também oferece funcionalidades convenientes para usar essas funções de geocodificação no lado do servidor.
Neste artigo, vamos mostrar como implementar a funcionalidade de geocodificação usando o ambiente de execução JavaScript do lado do servidor, especificamente o Node.JS para isso.
O que você precisa para seguir os passos
- ArcGIS Conta de desenvolvedor
Se você não tiver uma, siga as instruções em aqui para criar uma (gratuito). Criar essa conta permitirá que você use serviços para funcionalidades como mapas base, geocodificação e roteamento.
Siga as instruções em aqui para criar uma API
- key (token de acesso) para acessar o serviço de geocodificação.
Node.jsInstale o . Neste exemplo, usaremos o ambiente local do Windows com o editor Visual Studio Code.Node.js para executar.
Instalação do pacote ArcGIS REST JS
A maneira mais fácil de implementar a funcionalidade de geocodificação é usar o pacote ArcGIS REST JS junto com o serviço de geocodificação.Usando o Visual Studio Code, crie um projeto Node.js . No exemplo abaixo, criaremos na pasta "C:\temp\restjs-geocoding".O comando npm init solicitará algumas entradas; você pode inserir valores arbitrários ou simplesmente pressionar Enter sem digitar nada.
Em seguida, referencie dois pacotes ArcGIS REST . O primeiro é o pacote request, que inclui helpers de autenticação para validar requisições. O segundo é o pacote geocoding,, que é uma biblioteca usada para acessar várias operações de geocodificação como: findAddressCandidates, (geocodificação), geocodeAddresses, (geocodificação em lote), reverseGeocode, (geocodificação reversa), e suggest, (autocompletar endereços). Para instalar esses pacotes, use o comando abaixo com o npm.
スクリプトファイルを作成する
1. Node.js プロジェクトを作成したフォルダに index.js ファイルを作成し、Visual Studio Code でコードを記述していきます。
2. ES モジュールからエクスポートを指定して、必要なコンポーネントを参照します。
import { ApiKeyManager } from '@esri/arcgis-rest-request';
import { geocode } from '@esri/arcgis-rest-geocoding';
3. ArcGIS Developers ダッシュボード に移動して、API キーを取得します。ジオコーディングサービスにアクセスするための許可（Geocoding (not stored)）が設定されていることを確認します（API キー作成時にデフォルトで設定されます）。
4. Visual Studio Code で、ApiKeyManager を使用して、リクエストの認証パラメータを定義します。API キーは安全に保管する必要があるため、リポジトリにコミットしないでください。 API キーには、環境変数または外部構成ファイル (.gitignore で無視される) を使用することをお勧めします。
const apiKey = "API キーを入力";
const authentication = ApiKeyManager.fromKey(apiKey);
5. geocodeインポートでジオコーディングサービスにアクセスします。以下のパラメータを指定して geocodeメソッドを使用し、緯度・経度・正確な住所文字列の候補を取得します。最も正確な結果を得るには、以下のように、address (住所文字列)、postal（郵便番号/オプション）、 countryCode（国コード/オプション）、authentication パラメータを使用します。
geocode({
address: "東京都千代田区平河町２－７－１",
postal: "102-0093",
countryCode: "JP",
authentication
});
6. 最後に、アプリケーションを実行する前に、コンソールに結果を出力するコードを追加します。スクリプト ファイル全体は、次のようになります。
import { ApiKeyManager } from "@esri/arcgis-rest-request";
import { geocode } from "@esri/arcgis-rest-geocoding";
const apiKey = "API キーを入力";
const authentication = ApiKeyManager.fromKey(apiKey);
geocode({
address: "東京都千代田区平河町２－７－１",
postal: "102-0093",
countryCode: "JP",
authentication
}).then((response) => {
response.candidates.forEach((res) => {
console.log(res);
})
});
アプリケーションを実行する
Visual Studio Code のターミナル ウィンドウでアプリケーションを実行します。結果は以下の例のようになるはずです。
「Warning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension.」のエラーが出た場合は、package.json に「"type": "module"」を追加します。
結果には、ジオコーディング サービスによって検索された住所の以下の内容が含まれます。複数の住所の候補が含まれる場合もあります。
- location: x（経度）とy（緯度）の値と空間参照。
- score: 検証のために使用される一致の正確さ。100 は完全一致を表し、値が小さくなるほど精度が下がることを表します。
- attributes: デフォルトの戻り値、または検索時に outFields パラメータで指定された値。
ジオコーディングの結果を保存する場合
ジオコーディング結果を保存して再利用したい場合があるかもしれません。例えば、ArcGIS のデータベースではなく自身の持つデータベースに、ジオコーディングサービスを使用して取得した住所文字列や緯度経度の値などを保存して業務で使用するなどが考えられます。
この場合は、結果を保存しない場合と消費する料金が異なるため、ジオコーディングのパラメータに forStorage:true を設定する必要があります。
geocode({
address: "東京都千代田区平河町２－７－１",
postal: "102-0093",
countryCode: "JP",
params: {forStorage:true},
authentication
});
また、API キー作成時に「Geocoding (stored)」の機能を有効化する必要もあります。
ArcGIS Platform を使用した場合のジオコーディングの価格については、こちらのページを参照してください。
まとめ
今回は、Node.js と ArcGIS REST JS を使用してジオコーディング機能を実装する簡単な方法を紹介しました。ArcGIS REST JS には、ルート検索や空間分析など、他にも多くの機能を提供しています。サーバーサイドで、マッピング機能を構築する際には、ぜひご活用ください。
関連リンク
ArcGIS REST JS
ArcGIS Platform
