Batch Geocoder API 開発者ガイド

バッチ要求の出力を読み取り中です

バッチジオコーディングまたはリバースバッチジオコーディング要求が成功した結果として生成された出力データには、元のジョブ要求で指定されたデータ項目が含まれます。要求がジオコーディング用であるか、リバースジオコーディング用であるかに関係なく、出力のレイアウトは同じです。最初の 3 つの列は固定されており、常にです。

recId
seqNumber
seqLength

recIdは入力で指定した ID と同じです。また、seqNumberseqLength入力アドレスのあいまいな結果の数を指定するために使用されます。たとえば、「 425 Randolph St 」と入力すると、次の 2 つの結果が得られます。 E および W Randolph St. seqLength は、返されたレコードの数です。この場合、 2 つのレコードが返され、両方の結果がで並べ替え seqNumberられます。結果が recId および seqNumber でソートされる保証はありません。

以下の例では、入力データの入力データ例の完全な出力を確認できます。

recId|seqNumber|seqLength|displayLatitude|displayLongitude |houseNumber|street|city|postalCode|country|
1|1|2|41.8838692|-87.6389008|425|W Randolph St|Chicago|60606|USA
1|2|2|41.8842278|-87.6169052|425|E Randolph St|Chicago|60601|USA
2|1|1|42.3508682|-71.0714874|31|Saint James Ave|Boston|02116|USA
3|1|1|52.5304108|13.3852701|117|Invalidenstraße|Berlin|10115|DEU

基本出力フィールド

表 1. 全般
`recId`	応答の入力アドレスを示します
`seqNumber`	対応する入力レコードの異なる結果に、連続して 1 から順に番号が付けられます
`seqLength`	対応する入力レコードの結果の数

表 2. 地理的な場所
`displayLatitude`	表示位置の緯度
`displayLongitude`	表示位置の経度
`navigationLatitude` ( と同じ `latitude`)	ナビゲーション位置の緯度
`navigationLongitude` ( と同じ `longitude`)	ナビゲーション位置の経度
`mapViewBottomRightLatitude`	MapView の右下隅の緯度
`mapViewBottomRightLongitude`	MapView の右下隅の経度
`mapViewTopLeftLatitude` ( と同じ `latitude`)	MapView の左上隅にある緯度
`mapViewTopLeftLongitude` ( と同じ `longitude`)	MapView の左上隅にある経度

表 3. 住所
`street`	番地を参照します。
`houseNumber`	番地。地域の特性に応じて、自宅名にすることもできます。番地と番地のフィールドが別々にサポートされていない API の実装では、このフィールドは省略できます。
`building`	建物名
`subdistrict`	地区の下の下位区分レベルを含みます。このフィールドは、現在インドの結果にのみ使用されています。インドでは、典型的に、区レベル未満のエリアの名前を使用して対処しています。
`district`	市区町村の下位区分が含まれます。 2 番目のサブディビジョンレベルが使用できない場合、このフィールドの使用は任意です。
`city`	アドレスのローカル性を参照します。
`postalCode`	郵便番号
`county`	国の下位区分の 2 番目のレベルが含まれます。 2 番目のサブディビジョンレベルが使用できない場合、このフィールドの使用は任意です。
`state`	国の下の最初の下位区分レベルが含まれます。一般的に使用されているのは州コードです ( たとえば、カリフォルニア州の場合は CA) 。
`country`	ISO 3166-alpha-3 国コード
`addressLines`	解析されたアドレスコンポーネントから構築された、書式設定されたアドレス行。 1 行目には、番地の接頭辞、通りの種類、番地などの通りの名前と番地が表示されます。 2 行目は、市区町村名と郵便番号に加えて、国によっては州名または略語で構成されています。これらの要素は `MatchLevel` 、が番地以上の場合にのみ入力されます。市区町村の一致に住所行が含まれていません。
`addressAdditionalData`	SearchRequest additionalData フィールドで PreserveUnitDesignators スイッチが true に設定されている場合、 US Postal Service によって定義されたセカンダリアドレス単位を認識して返すことができます。認識されたアドレスの単位が AdditionalData フィールドに返されます。ここで、デジグネータはキーで、単位の値はエントリの値です。このようなキーの例としては、次の値があります。 `APT` アパート `BLDG` 建物 `FL` フロア `STE` スイート（部屋） `UNIT` ユニット `UNIT` 部門 `UnknownUnit` 認識できないアドレス単位の値です。通常は、シャープ記号 (#) で印刷されます例 :`CountryName=Vereinigte Staaten; StateName=Illinois`

表 4. 書式設定されたローカライズ済み住所
`locationLabel`	表示目的でアセンブルされたアドレス値。

表 5. 住所一致情報
`relevance`	見つかった結果の関連性を示します。スコアが高いほど、代替案の関連性が高くなります。スコアは 0 ～ 1 の正規化された値です。
`matchType`	位置情報の一致品質。 `pointAddress:` 場所がポイントの住所と完全に一致しています。 `interpolated:` 位置情報が補間されました。
`matchCode`	結果がリクエストとどの程度一致しているかを示すコード。列挙 [`exact`, `ambiguous`, `upHierarchy`, `ambiguousUpHierarchy`]。
`matchLevel`	入力レコードに一致した最も詳細な住所フィールド
`matchQualityStreet`	MatchQuality は、属性レベルでの結果の一致精度に関する詳細情報を提供します。一致精度は 0.0 ～ 1.0 の値です。 1.0 は 100% の一致を表します。 ( たとえば `matchQualityCity` 、は都市情報に関する結果の質です ) 。
`matchQualityHouseNumber`
`matchQualityBuilding`
`matchQualityDistrict`
`matchQualityCity`
`matchQualityPostalCode`
`matchQualityCounty`
`matchQualityState`
`matchQualityCountry`

以下の属性は、応答で使用されるマップオブジェクトのさまざまな側面を参照しています。

注 : リクエストにlocationattributes= (mrmapReferenceallのいずれか) を追加するか、値mrmapReferenceまたはallがlocationattributesの列を入力に追加する必要があります。

表 6. 地図参照
`mapReferenceId`	リンクの PVID （アドレスレベルの結果の場合）。
`mapReferenceMapId`	マップスキーマの基本行と週次更新の識別子を含むマップバージョンの詳細。形式 : <4 文字のリージョン >`YYQ`<weekly update> 例 : NAAM15135 ( 地域 : 北米 (NAAM) 、地図スキーマ： 2015 年第 1 四半期（ 151 ）、週次アップデート 35 ）
`mapReferenceMapVersion`	マップスキーマのバージョン。形式 : QQ/YYYY （ 2016 年第 3 四半期など）
`mapReferenceMapReleaseDate`	マップデータのリリース日。形式 : YYYY-MM-DD
`mapReferenceSideOfStreet`	参照先がリンクの左側にあるか、右側にあるかを示します ( 参照ノードから非参照ノードに向かっている場合 ) 。列挙 [`left`, `right`, `neither`]
`mapReferenceSpot`	リンクに沿った位置の相対的な位置。スポットは、リンクの参照ノードから非参照ノードまでの分数距離として定義されます。値の範囲は 0 ～ 1 です。この属性は、リンクが参照されている場合にのみ関連します。
`mapReferenceCountryId`	国の管理エリアの PVID 。
`mapReferenceStateId`	状態管理領域の PVID 。
`mapReferenceCountyId`	郡管理者エリアの PVID 。
`mapReferenceCityId`	市区町村管理者エリアの PVID 。
`mapReferenceDistrictId`	地区管理者エリアの PVID 。
`mapReferenceAddressId`	Point Address の PVID 。 `matchLevelhouseNumber` およびの結果にのみ使用 `matchType` `pointAddress`できます。 `interpolated` 結果には使用できません。

住所の詳細タイプには、住所に関する追加情報が表示されます。住所要素の名前が、この名前の言語情報とともに一覧表示されます。

注 : リクエストにlocationattributes= (dtaddressDetailsallのいずれか) を追加するか、値dtaddressDetailsまたはallがlocationattributesの列を入力に追加する必要があります。

表 7. 住所の詳細
`addressDetailsCountryCode`	ISO 3166-alpha-3 国コード。
`addressDetailsCountry`	国名。
`addressDetailsCountryLanguage`	国の言語情報。
`addressDetailsState`	州名。
`addressDetailsStateLanguage`	州の言語情報。
`addressDetailsCounty`	州名。
`addressDetailsCountyLanguage`	国の言語情報。
`addressDetailsCity`	市区町村名。
`addressDetailsCityLanguage`	都市言語情報。
`addressDetailsDistrict`	地区名。
`addressDetailsDistrictLanguage`	地域の言語情報。
`addressDetailsStreet`	番地。
`addressDetailsStreetLanguage`	番地の言語情報。
`addressDetailsHouseNumber`	番地。
`addressDetailsHouseNumberLanguage`	番地の言語情報。
`addressDetailsPostalCode`	郵便番号。
`addressDetailsBuilding`	建物名。
`addressDetailsBuildingLanguage`	言語情報を作成しています。

道路の詳細タイプには、道路に関する追加情報が表示されます。道路の詳細タイプでは、道路名がベース名、番地タイプ、その他の情報などの名前部分に分解されます。

注 : リクエストにlocationattributes= (sdstreetDetailsallのいずれか) を追加するか、値sdstreetDetailsまたはallがlocationattributesの列を入力に追加する必要があります。

表 8. 番地の詳細
`addressDetailsStreetDetailsBaseName`	番地のベース名の一部。ベース名は、番号付きルート、ローカル名、または一般的に受け入れられる通りの名前です。
`addressDetailsStreetDetailsPrefix`	接頭辞は、道路のベース名の前に付けられているが、そこには含まれていない指向性識別子です。
`addressDetailsStreetDetailsSuffix`	接尾辞は、道路のベース名の後に続くが、そこに含まれていない指向性識別子です。
`addressDetailsStreetDetailsDirection`	高速道路に割り当てられている公式の方向識別子を示します。通常は、「北 / 南」または「東 / 西」です。
`addressDetailsStreetDetailsStreetType`	番地の一部を入力します。道路タイプは、各道路の自治体指定番号です。たとえば、「 street 」、「 road 」、「 Strasse 」、「 straat 」、 "via" 、または "rue de la" のいずれかを選択します。道路タイプは、ベース名の前または後に「あり」、ベース名に「添付済み」または「未添付」として定義されます。
`addressDetailsStreetDetailsStreetTypeBefore`	道路タイプがベース名の前後のどちらであるかを定義します。
`addressDetailsStreetDetailsStreetTypeAttached`	道路タイプがベース名に添付されているか、または添付されていないかを定義します。

表 9. 雑則
`locationType`	場所が [ エリア、ポイント、ライン ] かどうかを示します。
`locationId`	物理的な場所を一意に識別するキー。
`responseAdditionalData`	番地のフォールバックなど、結果に関する追加情報。 `houseNumberFallbackDifference=1; houseNumberFallback=true`

表 10. 解析済みリクエスト情報
`parsedRequestName`	入力トークンパーサーがランドマークの名前として分類しました。
`parsedRequestLabel`	解析されたアドレスコンポーネントから構築されたアセンブル済みのアドレス値。
`parsedRequestCountry`	入力トークンパーサーが住所の国の一部として分類しました。
`parsedRequestState`	入力トークンパーサーがアドレスの状態の一部として分類しました。
`parsedRequestStreet`	入力トークン : パーサーは、住所の番地の一部として分類されています (2 つの道路で定義された交差点を含む ) 。
`parsedRequestCounty`	入力トークン : パーサーは、住所の郡の一部として分類されています。
`parsedRequestCity`	入力トークン : パーサーは、住所の市区町村の一部として分類されています。
`parsedRequestDistrict`	入力トークンパーサーがアドレスの領域の一部として分類しました。
`parsedRequestSubDistrict`	入力トークンパーサーがアドレスのサブディストリクト部分として分類しました。
`parsedRequestHouseNumber`	入力トークンパーサーは、住所の番地の一部として分類されています。
`parsedRequestPostalCode`	入力トークンパーサーが住所の郵便番号部分として分類しました。
`parsedRequestBuilding`	入力トークンパーサーは、住所の建物の一部として分類されています。
`parsedRequestAddressLines`	解析されたアドレスコンポーネントから構築された、書式設定されたアドレス行。 1 行目には、番地 ( 接頭辞、道路の種類、番地、番地など ) と番地が表示されます。 2 行目は、市区町村名と郵便番号に加えて、国によっては州名または略語で構成されています。これらの要素は `MatchLevel` 、が番地以上の場合にのみ入力されます。市区町村の一致に住所行が含まれていません。
`parsedRequestAdditionalData`	解析された住所コンポーネントから構築された US Postal サービスによって定義されたセカンダリ住所の単位。認識されたアドレスの単位が AdditionalData フィールドに返されます。ここで、デジグネータはキーで、単位の値はエントリの値です。このようなキーの例としては、次の値があります。 `APT` アパート `BLDG` 建物 `FL` フロア `STE` スイート（部屋） `UNIT` ユニット `UNIT` 部門 `UnknownUnit` 認識できないアドレス単位の値です。通常は、シャープ記号 (#) で印刷されます例 :`CountryName=Vereinigte Staaten; StateName=Illinois`
`parsedRequestPosition`	入力トークンパーサーが要求の位置として分類しました。