このカタログでは聞こえるより珍しいことで、このページが「宣言された」ではなく「確認された」カラムについて語れる理由でもあります。
公開リファレンスはリクエスト側を文書化しています - 住所を入力し、1リクエストあたり最大1,000件までまとめられます - そして異例なことに、11のレスポンスフィールドも列挙しています: query、latitude、longitude、country、state、city、borough、street、postal_code、time_zone、street_view。
当社は7行・2種類のクエリにわたる5件の実エクスポートを保有しています。現行の形式はその11にさらに9つを加えて返します - address、lat、lon、matched_address、type、class、importance、osm_type、osm_id - 合計20カラムです。より古い実行はその9つだけを返しました。つまり2つの情報源は重なる範囲で互いを裏づけており、エクスポートのほうが広い側です。
20のいずれもが少なくとも1行で実際の値を持っていたため、下のデータ辞書は言葉を濁さず各カラムの内容を記述しています。2つの例外は誠実なものです。borough と street は Central Park, NY で空で返りました。公園には番地がないからです。
入力は住所だけです。設定するフィルターはありません。
完全な住所でも、名所の名前だけでも機能します - リファレンス自身の例は 321 California Ave, Palo Alto, CA 94306 と Central Park, NY であり、どちらもこのページの根拠となるエクスポートに含まれています。
7行・2種類のクエリにわたる5件の実エクスポートから測定しました。名称はヘッダー行から一字一句そのまま、シートの順序で写しています。以下の例示値はそれらの実行の実際のセルです。
37.4270819。latitude と同一です。下の注記を参照してください。-122.1439887。longitude と同一です。321, South California Avenue, Evergreen Park, Palo Alto, Santa Clara County, California, 94306, United States。house、セントラルパークでは park。place と leisure。class と type は対で読んでください。0.0001、セントラルパークは 0.612。node、公園は way。1734450110。結合キーとして使える程度に安定しています。lat と同じ文字列値です。lon と同じ文字列値です。United States。California、New York。Palo Alto、New York。Evergreen Park。セントラルパークでは空。この構成要素を持たないためです。321 South California Avenue。セントラルパークでは空。番地がないためです。94306。大きな面的地物では検算する価値があります。下の注記を参照してください。America/Los_Angeles、America/New_York。現地時刻の計算にそのまま使えます。https://www.google.com/maps?q=&layer=c&cbll=37.4270819,-122.1439887。上記のすべてのカラムが、当社の保有する実行で実際の値を持ちました。だからこの表は言葉を濁さず内容を記述しています。2つのセルは正当に空でした - 公園における borough と street - が、これは場所の性質であって照会の失敗ではありません。標本は小さく、意図的に百分率で表現していません。2クエリ・7行は、エクスポートの形を確実に教えてくれますが、大量実行時の的中率については何も語りません。まず無料枠でご自身のファイルの一部を流してください。
いずれもリファレンスではなくエクスポートを読んで得られたものです。だからこそ紙幅を割く価値があります。
lat と latitude は同じ値を持ち、lon と longitude も同様です - 当社が保有するすべての行で。どちらがより正式ということはありません。旧来の9カラム形式には短いほうの対しかないだけです。両方とも数値ではなく文字列である点にご注意ください。計算前にキャストしないと、-122 が -73 の隣に辞書順で並びます。
Central Park, NY を送ると座標と一致住所は返りますが、borough と street は空で戻ります。与えるべき番地が存在しないからです。パイプラインが street の欠落を照会失敗として扱うと、まったく問題のない行を捨ててしまいます。住所の各項目が埋まっているかではなく、座標があるかどうかで分岐してください。
セントラルパークの行は postal_code が 11025 で返りました。セントラルパークの郵便番号は 100xx 台なので、この値は公園を表していません。大きなポリゴンは代表点から住所の各項目を取得するため、多数の郵便番号にまたがる地物では結果が範囲外に落ちることがあります。座標は信頼し、郵便番号は郵送に使ったり結合キーにしたりする前に確認してください。
class と type は一致した地物の主要 OSM タグのキーと値、osm_type と osm_id はオブジェクトそのものを指し、importance は OSM が算出した重要度ランクです。これは実用的です: class でフィルタすれば建物を残して公園を除けますし、importance は名所と一軒の玄関を分けます - 当社の2行では 0.612 対 0.0001 でした。
ジオコーディングは配管です - 面白い分析が始まる前に動いていなければならないものです。
解決された各行が緯度と経度を持つため、顧客の表がプロットでき、クラスタリングでき、商圏を描ける対象になります。1リクエストで最大1,000住所を扱えるので、大きなファイルもレート制限の問題ではなく数回の呼び出しで済みます。
分解済みのカラムは、座標だけではできないことをします。state、city、postal_code が独立した項目で届くため、アカウントを営業テリトリーやサービス提供地域に割り当てる作業が、文字列解析ではなく結合になります。
time_zone は America/Los_Angeles のような IANA 名で返ります。これはまさに日付ライブラリが求める形式です。「この顧客の現地は今何時か」が、国からの推測ではなく、夏時間にも耐える正しい答えになります。
サブスクリプションなし、最低利用額なし、席数ライセンスなし。最初の500行は当社負担、以降は従量課金です。
新規アカウントごとに初回限定。クレジットカード不要。住所ファイルの実際の一部を流し、扱いにくい行 - 省略形、欠けた郵便番号、名所 - にどう対応するかを見るには十分です。
1,000住所あたり約 $2、1住所につき1行 - 何も解決しない住所でもきっかり1行返るため、予算は正確に見積もれます。
大きなファイルを定期的にジオコーディングするチーム向けに、ボリューム価格、SLA、専用ワーカー、個別オンボーディングをご用意します。数量をお知らせいただければお見積りします。
LIVESCRAPER10 をご利用ください。一方は座標を住所に戻し、もう一方はそこにどんな事業者があるかを教えます。
カタログの中でも軽い部類の問いですが、単に断言するのではなく理由を述べる価値があります。
住所、その座標、そのタイムゾーンは場所についての事実です。この20カラムのどれも人物を記述しません。氏名も、居住者も、連絡先もありません。基礎となる地理情報は公開の共同地図である OpenStreetMap に由来し、だからこそエクスポートは OSM 自身のオブジェクト ID とタグを保持しています。
考えるべきなのは入力のほうです。送信する住所が顧客の自宅住所であるなら、そのリストは当社に届く前から個人データであり、その後も個人データのままです。ジオコーディングは人に関するレコードに精度を加える行為です。ファイルはそれに見合った扱いをしてください。住所の所在ではなく、そこに誰が住んでいるかを知る必要がある場合、それは別の、はるかに強く制限されたカテゴリであり、独自の利用ルールを持つ Whitepages Addresses が扱います。
当社側について: 公開されている情報源のみを利用し、ログインの背後にあるものは扱わず、データ層にサードパーティのトラッカーは置かず、エクスポートは30日で自動削除されます。
最も多く寄せられる質問です。ほかにご不明な点があればご連絡ください - 回答を書くのはボットではなく人間です。
query、latitude、longitude、country、state、city、borough、street、postal_code、time_zone、street_view - そしてエクスポートはさらに9つを加えます: address、lat、lon、matched_address、type、class、importance、osm_type、osm_id。このページの根拠となる実行では、20のいずれもが実際の値を持ちました。address、lat、lon、matched_address、type、class、importance、osm_type、osm_id だけを返します。現行のほうはそれにリファレンスが文書化する11を加えて返します。固定ヘッダーを前提とせず、インポーターは9つを対象に書き、残りは「あれば使う」として扱ってください。lon と longitude も同様です。短い対は両方のエクスポート形式に現れ、長い対は広いほうにしかありません。単一のコードパスにしたいなら lat と lon を読んでください。どちらも文字列で届くため、計算や並べ替えの前にキャストしてください。Central Park, NY を送ると座標、一致住所、市、州、タイムゾーンは返りますが、番地も地区も返りません。公園にはそれらがないのです。住所の各項目が埋まっているかではなく、座標があるかどうかで成功と判断してください。postal_code が 11025 で返りましたが、これはセントラルパークの郵便番号ではありません。大きなポリゴンは代表点から住所の各項目を取得するため、多数の郵便番号にまたがる地物ではその点が範囲外に落ちることがあります。信頼できるのは座標です。郵便番号で郵送経路を決める前に検証してください。ジオコーディングは、あらゆる位置分析が始まる前に機能していなければならない工程です。人が入力した住所の列が、プロットでき、計測でき、結合できる座標の組に変わります。本サービスはそれをまとめて行います。住所のリストを送信してください - 321 California Ave, Palo Alto, CA 94306 のような完全な住所でも、Central Park, NY のような名所だけでも構いません。どちらも公開リファレンス自身の例です。各件は1行として返るため、入力ファイルと出力ファイルが正確に対応します。
現行のエクスポートは20カラムを持ち、このページはカタログの中では珍しく、そのすべてを単なるヘッダーではなく測定に基づいて記述できます。11はリファレンスが公開しています: 送信クエリの返し、緯度と経度、国、州、市、地区、street、郵便番号、IANA タイムゾーン、そして座標から組み立て済みの Google ストリートビューのリンク。エクスポートはリファレンスが触れていない9つを加えます: 送信したままの住所、短い lat/lon の対、完全に正規化されたカンマ区切りの住所、そして OpenStreetMap から直接得た5項目 - 地物の主要タグの class と type、そのオブジェクトの OSM 種別と ID、そして OpenStreetMap が算出した重要度ランクです。7行を含む5件の実エクスポートを通じて、20のいずれもが少なくとも一度は実際の値を持ちました。
インポーターを書く方には4点が重要で、いずれも仮定ではなく観測に基づきます。座標は二重に届き - lat と latitude は同じ値、lon と longitude も同様 - そして両方とも数値ではなく文字列なので、計算や並べ替えの前にキャストが必要です。名所は住所ではありません。セントラルパークの行は座標、市、タイムゾーンを返しましたが street も地区も返しませんでした。公園にはどちらもないからです。したがってパイプラインは、すべての住所項目を要求するのではなく、座標の存在をもって成功と扱うべきです。郵便番号は大きな地物では確認に値します。同じ公園の行は、実際にセントラルパークを覆う 100xx 台の外の郵便番号を返しました。これは多数の郵便番号にまたがるポリゴンが代表点の値を報告するときに起きます。そして OpenStreetMap の各項目は装飾ではなく実用的です。class でフィルタすれば建物と公園を分けられ、importance は名所と玄関を分けます - 当社の2行では 0.612 対 0.0001 でした。
法的には、これはカタログの中でも最も軽い部類のサービスです。住所、その座標、そのタイムゾーンは場所についての事実であり、20カラムのどれも人物を記述しません。基礎となる地理情報は公開の共同地図である OpenStreetMap に由来します。考えるべきなのは入力のほうです。送信する住所が顧客の自宅住所であれば、そのリストは当社に届く前から個人データであり、その後もそうであり続けるため、相応の扱いが必要です。公開されている情報源のみ、ログインの背後にあるものは扱わず、データ層にサードパーティのトラッカーはなく、エクスポートは30日で自動削除されます。最初の500行は無料でクレジットカードも不要です。