Géocodage

Une adresse entre.
Des coordonnées sortent.

Soumettez une liste d'adresses et recevez chacune sous forme de ligne - latitude et longitude, l'adresse normalisée en une forme postale complète, et pays, État, ville, rue, code postal et fuseau horaire répartis dans leurs propres colonnes. Vingt colonnes dans la forme actuelle, toutes mesurées sur des exports réels.

500 lignes offertes, une seule fois0,002 $ par ligne ensuitejusqu'à 1 000 adresses par requêteCSV · JSON · Excel
À lire en premier

La référence et l'export
sont d'accord.

C'est plus rare qu'il n'y paraît dans ce catalogue, et c'est pourquoi cette page peut parler de colonnes confirmées plutôt que déclarées.

La référence publiée documente le côté requête - des adresses en entrée, par lots allant jusqu'à 1 000 par requête - et, fait inhabituel, elle énumère aussi onze champs de réponse : query, latitude, longitude, country, state, city, borough, street, postal_code, time_zone et street_view.

Nous détenons cinq exports réels couvrant sept lignes et deux requêtes distinctes. La forme actuelle renvoie ces onze champs plus neuf autres que la référence ne mentionne pas - address, lat, lon, matched_address, type, class, importance, osm_type et osm_id - soit vingt colonnes au total. Une exécution plus ancienne n'a renvoyé que ces neuf-là. Les deux sources se corroborent donc là où elles se recoupent, et l'export est la plus large des deux.

Chacune des vingt a porté une valeur réelle sur au moins une ligne, raison pour laquelle le dictionnaire de données ci-dessous décrit ce que contient chacune plutôt que de prendre des précautions. Les deux exceptions sont honnêtes : borough et street sont revenues vides pour Central Park, NY, car un parc n'a pas de numéro de rue.

livescraper.app · ce qui est vérifié
L'entrée est une adresse - documenté
Jusqu'à 1 000 adresses par requête - documenté
11 champs de réponse - documentés ET mesurés
9 colonnes de plus - mesurées sur les exports
Les composantes d'adresse peuvent manquer pour les objets surfaciques!
Noms de colonnes repris de l'en-tête de l'export.
Comment ça marche

Adresses en entrée,
lignes en sortie.

Une adresse constitue toute l'entrée. Il n'y a aucun filtre à configurer.

  1. ÉTAPE 1Connectez-vous à la plateforme.
  2. ÉTAPE 2Ouvrez le Géocodage.
  3. ÉTAPE 3Collez vos adresses, une par ligne.
  4. ÉTAPE 4Choisissez votre format de sortie.
  5. ÉTAPE 5Cliquez sur Get Data et lisez les coordonnées.

Une adresse complète comme un simple monument fonctionnent tous deux - les exemples de la référence elle-même sont 321 California Ave, Palo Alto, CA 94306 et Central Park, NY, et les deux figurent dans les exports derrière cette page.

Dictionnaire de données

Vingt colonnes,
et ce que chacune contenait.

Mesuré sur 5 exports réels couvrant 7 lignes et 2 requêtes distinctes. Les noms sont copiés caractère par caractère depuis la ligne d'en-tête, dans l'ordre de la feuille. Les valeurs d'exemple ci-dessous sont de vraies cellules issues de ces exécutions.

address
L'adresse exactement telle que vous l'avez soumise. Présente sur chaque ligne de chaque exécution.
lat
Latitude, sous forme de chaîne - p. ex. 37.4270819. Identique à latitude ; voir la note ci-dessous.
lon
Longitude, sous forme de chaîne - p. ex. -122.1439887. Identique à longitude.
matched_address
L'adresse normalisée en une forme postale complète séparée par des virgules : 321, South California Avenue, Evergreen Park, Palo Alto, Santa Clara County, California, 94306, United States.
type
La valeur du tag OpenStreetMap principal de l'objet trouvé - house pour l'adresse postale, park pour Central Park.
class
La clé de ce même tag - place et leisure respectivement. Lisez class et type comme une paire.
importance
Le rang d'importance calculé par OpenStreetMap. L'écart est large et parlant : 0.0001 pour la maison, 0.612 pour Central Park.
osm_type
Quel type d'objet OpenStreetMap a été trouvé - node pour la maison, way pour le parc.
osm_id
L'identifiant OpenStreetMap de cet objet, sous forme de nombre - p. ex. 1734450110. Assez stable pour servir de clé de jointure.
query
L'adresse renvoyée telle quelle. Présente dans la forme à 20 colonnes ; absente de l'ancienne à 9.
latitude
Latitude à nouveau, même valeur de chaîne que lat.
longitude
Longitude à nouveau, même valeur de chaîne que lon.
country
Nom du pays en toutes lettres - United States.
state
État ou région - California, New York.
city
Ville - Palo Alto, New York.
borough
Quartier au sein de la ville - Evergreen Park. Vide pour Central Park, qui n'a pas cette composante.
street
Ligne de rue - 321 South California Avenue. Vide pour Central Park, qui n'a pas de numéro de rue.
postal_code
Code postal - 94306. À vérifier sur les grands objets surfaciques ; voir la note ci-dessous.
time_zone
Nom de fuseau horaire IANA - America/Los_Angeles, America/New_York. Directement utilisable pour les calculs d'heure locale.
street_view
Un lien Google Street View déjà construit à partir des coordonnées, p. ex. https://www.google.com/maps?q=&layer=c&cbll=37.4270819,-122.1439887.

Chaque colonne ci-dessus a porté une valeur réelle dans les exécutions que nous détenons, ce qui explique que ce tableau décrive des contenus plutôt que de prendre des précautions. Deux cellules étaient légitimement vides - borough et street sur le parc - et c'est une propriété du lieu, non un échec de la recherche. L'échantillon est petit et volontairement non exprimé en pourcentage : 7 lignes sur 2 requêtes vous disent de façon fiable quelle forme a un export, et rien sur les taux de réussite à grande échelle. Passez d'abord une tranche de votre propre fichier sur l'offre gratuite.

Avant de le brancher

Quatre notes pour qui
écrira l'importateur.

Chacune est issue de la lecture des exports plutôt que de la référence, et c'est pour cela qu'elles méritent leur place.

Les coordonnées arrivent en double, sous forme de chaînes

lat et latitude portent la même valeur, tout comme lon et longitude - sur chaque ligne que nous détenons. Aucune n'est plus faisant autorité que l'autre ; l'ancienne forme à 9 colonnes n'a simplement que la paire courte. Notez que les deux sont des chaînes et non des nombres : convertissez-les avant tout calcul, faute de quoi vous trierez -122 à côté de -73 par ordre alphabétique.

Un monument n'est pas une adresse - attendez-vous à des champs vides

Soumettre Central Park, NY renvoie des coordonnées et une adresse correspondante, mais borough et street reviennent vides, faute de numéro de rue à donner. Si votre traitement considère une rue absente comme une recherche échouée, il écartera des lignes parfaitement bonnes. Branchez sur la présence de coordonnées, pas sur le remplissage de chaque composante.

Vérifiez le code postal sur les grands objets

La ligne Central Park est revenue avec postal_code 11025. Les codes postaux de Central Park sont dans la plage 100xx, cette valeur ne décrit donc pas le parc. Un grand polygone tire ses composantes d'adresse d'un point représentatif, et pour un objet couvrant de nombreux codes postaux le résultat peut tomber en dehors. Fiez-vous aux coordonnées ; vérifiez le code postal avant d'acheminer du courrier ou de faire une jointure dessus.

class, type et importance sont le vocabulaire propre d'OpenStreetMap

class et type sont la clé et la valeur du tag principal de l'objet trouvé, osm_type et osm_id pointent vers l'objet lui-même, et importance est le rang d'importance calculé par OSM. C'est réellement utile : filtrer sur class permet de garder les bâtiments et d'écarter les parcs, et importance distingue un monument d'une porte d'entrée - 0.612 contre 0.0001 sur nos deux lignes.

Flux de travail courants

Trois travaux que l'on
lance le plus souvent ici.

Le géocodage est de la plomberie - c'est ce qui doit fonctionner avant que l'analyse intéressante ne commence.

Cartographier une liste de clients

Transformer une colonne d'adresses en points sur une carte

Chaque ligne résolue porte latitude et longitude : un tableur de clients devient donc quelque chose que l'on peut représenter, regrouper et entourer de zones de chalandise. Une requête accepte jusqu'à 1 000 adresses, ce qui fait d'un gros fichier quelques appels plutôt qu'un problème de limite de débit.

Analytique · Ops
Territoires et tournées

Rattacher des enregistrements à la bonne région

Les colonnes déjà découpées font ce que les coordonnées seules ne peuvent pas : state, city et postal_code arrivent dans leurs propres champs, si bien que rattacher un compte à un territoire commercial ou à une zone d'intervention devient une jointure plutôt qu'un exercice d'analyse de chaînes.

Sales ops · Intervention terrain
Planifier entre fuseaux

Obtenir la bonne heure locale

time_zone revient sous forme de nom IANA comme America/Los_Angeles, exactement ce qu'attend une bibliothèque de dates. « Quelle heure est-il chez ce client » cesse d'être une supposition fondée sur le pays pour devenir une réponse correcte qui survit au changement d'heure.

Support · Logistique
Tarifs

Ne payez que les lignes
que vous extrayez vraiment.

Pas d'abonnement, pas de minimum, pas de licence par utilisateur. Vos 500 premières lignes sont offertes - ensuite, paiement à l'usage.

Offre gratuite

500 lignes offertes - 0 $

Pour chaque nouveau compte, une seule fois. Sans carte bancaire. De quoi passer une vraie tranche de votre fichier d'adresses et voir comment il se comporte sur les lignes bancales - les abréviations, les codes postaux manquants, les monuments.

0 $ pour toujours
Paiement à l'usage

0,002 $ par ligne après l'offre gratuite

Environ 2 $ pour 1 000 adresses, une ligne par adresse - budget exact, puisqu'une adresse qui ne résout rien renvoie tout de même exactement une ligne.

Le plus populaire
Enterprise

Sur mesure · traitements récurrents

Tarifs au volume, SLA, workers dédiés et onboarding sur mesure pour les équipes qui géocodent un gros fichier à intervalles réguliers. Donnez-nous vos chiffres et nous établirons un devis.

Parlons-en
10 % de remise sur votre première exécution payante.Utilisez le code LIVESCRAPER10 au paiement.
S'inscrire
Va bien avec

Le sens inverse,
et ce qui s'y trouve.

L'un retransforme les coordonnées en adresses ; l'autre vous dit quelles entreprises s'y trouvent.

Le volet juridique

Des faits sur des lieux,
pas sur des personnes.

L'une des questions les plus légères du catalogue, et il vaut la peine de dire pourquoi plutôt que de simplement l'affirmer.

Une adresse, ses coordonnées et son fuseau horaire sont des faits concernant un lieu. Rien dans ces vingt colonnes ne décrit une personne : ni nom, ni occupant, ni coordonnée de contact. La géographie sous-jacente provient d'OpenStreetMap, une carte collaborative publique, d'où les identifiants et tags propres à OSM que porte l'export.

Ce qui mérite réflexion, c'est votre entrée. Si les adresses que vous soumettez sont des domiciles de clients, cette liste était une donnée personnelle avant de nous parvenir et le reste ensuite - le géocodage ajoute de la précision à un enregistrement concernant une personne. Traitez le fichier en conséquence. Si vous devez savoir qui habite à une adresse plutôt qu'où elle se trouve, il s'agit d'une catégorie différente et bien plus encadrée, couverte par Whitepages Addresses avec ses propres règles d'usage.

De notre côté : uniquement des sources publiquement disponibles, rien derrière une authentification, aucun traceur tiers sur la couche de données, et vos exports s'auto-suppriment au bout de 30 jours.

livescraper.app · principes
Des lieux et des coordonnées, pas des personnes
Uniquement des sources publiquement disponibles
Rien derrière une authentification
Les exports s'auto-suppriment (30 jours)
Votre liste d'entrée peut rester une donnée personnelle!
Des faits sur un lieu, pas sur qui s'y trouve.
Questions fréquentes

Ce que l'on demande
avant de s'inscrire.

Les questions qui reviennent le plus. Autre chose ? Parlez-nous - ce sont des humains, pas des bots, qui rédigent les réponses.

Que revient-il exactement ?+
Vingt colonnes dans la forme actuelle. La référence en publie onze - query, latitude, longitude, country, state, city, borough, street, postal_code, time_zone et street_view - et l'export en ajoute neuf : address, lat, lon, matched_address, type, class, importance, osm_type et osm_id. Chacune des vingt a porté une valeur réelle dans les exécutions derrière cette page.
Pourquoi mon export a-t-il neuf colonnes au lieu de vingt ?+
Parce qu'il existe deux formes. L'ancienne ne renvoie que address, lat, lon, matched_address, type, class, importance, osm_type et osm_id ; l'actuelle renvoie celles-ci plus les onze que documente la référence. Écrivez votre importateur contre les neuf et traitez le reste comme présent-si-présent plutôt que de présupposer un en-tête fixe.
lat et latitude sont-elles différentes ?+
Non - elles portent des valeurs identiques sur chaque ligne que nous détenons, tout comme lon et longitude. La paire courte figure dans les deux formes d'export et la longue seulement dans la plus large : si vous voulez un seul chemin de code, lisez lat et lon. Toutes deux arrivent sous forme de chaînes, convertissez-les donc avant tout calcul ou tri.
Pourquoi street et borough sont-elles vides sur certaines lignes ?+
Parce que le lieu n'a pas cette composante. Soumettre Central Park, NY renvoie des coordonnées, une adresse correspondante, une ville, un État et un fuseau horaire, mais aucun numéro de rue et aucun quartier - un parc n'en a pas. Considérez une ligne comme réussie lorsqu'elle a des coordonnées, pas lorsque chaque composante est remplie.
Quelle est la précision du code postal ?+
Bonne pour les adresses postales, à vérifier pour les grands objets. La ligne Central Park de nos exports est revenue avec postal_code 11025, qui n'est pas un code postal de Central Park - un grand polygone tire ses composantes d'adresse d'un point représentatif, et pour un objet couvrant de nombreux codes postaux ce point peut tomber en dehors. Les coordonnées sont la partie fiable ; vérifiez le code postal avant d'acheminer du courrier avec.
Combien d'adresses puis-je soumettre en une fois ?+
La référence documente un traitement par lots allant jusqu'à 1 000 adresses par requête, envoyées sous forme de tableau. Nos propres exécutions étaient modestes - sept lignes sur cinq exports - nous citons donc ce chiffre comme documenté et non comme quelque chose que nous aurions éprouvé à cette échelle.
Combien cela coûte-t-il ?+
Les 500 premières lignes d'un nouveau compte sont gratuites et offertes une seule fois ; ensuite c'est 0,002 $ par ligne - environ 2 $ pour 1 000 adresses - au paiement à l'usage et sans abonnement. Une ligne par adresse rend le budget exact. Les crédits n'expirent pas et il n'y a pas de remise à zéro mensuelle.

Mettez votre fichier d'adresses
sur la carte.

Collez vos adresses et obtenez des coordonnées, des composantes d'adresse découpées et un fuseau horaire pour chacune. Vos 500 premières lignes sont gratuites - de quoi voir comment le service se comporte sur les lignes bancales de vos propres données.

Activation immédiate · sans carte bancaire

Géocodage - convertir des adresses en coordonnées à grande échelle

Le géocodage est l'étape qui doit fonctionner avant toute analyse de localisation : une colonne d'adresses saisies par des humains devient une paire de coordonnées que l'on peut représenter, mesurer et joindre. Ce service le fait en masse. Soumettez une liste d'adresses - une adresse complète comme 321 California Ave, Palo Alto, CA 94306, ou un simple monument comme Central Park, NY, tous deux exemples de la référence publiée elle-même - et chacune revient sous forme d'une ligne unique, si bien que le fichier d'entrée et celui de sortie se correspondent exactement.

L'export actuel porte vingt colonnes, et cette page est inhabituelle dans le catalogue en ce qu'elle peut toutes les décrire à partir de mesures plutôt que d'un simple en-tête. Onze sont publiées par la référence : la requête soumise renvoyée, latitude et longitude, pays, État, ville, quartier, rue, code postal, un fuseau horaire IANA et un lien Google Street View déjà construit à partir des coordonnées. L'export en ajoute neuf que la référence ne mentionne pas : l'adresse telle que soumise, une paire courte lat/lon, une adresse entièrement normalisée séparée par des virgules, et cinq champs tirés directement d'OpenStreetMap - la classe et le type du tag principal de l'objet, le type et l'identifiant OSM de celui-ci, et le rang d'importance calculé par OpenStreetMap. Sur cinq exports réels couvrant sept lignes, chacune des vingt a porté une valeur réelle au moins une fois.

Quatre détails comptent pour qui écrit l'importateur, tous observés plutôt que supposés. Les coordonnées arrivent en double - lat et latitude sont la même valeur, tout comme lon et longitude - et les deux sont des chaînes plutôt que des nombres, ce qui impose une conversion avant tout calcul ou tri. Un monument n'est pas une adresse : la ligne Central Park a renvoyé des coordonnées, une ville et un fuseau horaire mais ni rue ni quartier, car un parc n'en a aucun ; un traitement devrait donc considérer la présence de coordonnées comme un succès plutôt que d'exiger chaque composante. Les codes postaux méritent une vérification sur les grands objets : cette même ligne de parc a renvoyé un code hors de la plage 100xx qui couvre réellement Central Park, ce qui arrive quand un polygone couvrant de nombreux codes rapporte celui d'un point représentatif. Et les champs OpenStreetMap sont réellement utiles plutôt que décoratifs : filtrer sur class sépare les bâtiments des parcs, et importance distingue un monument d'une porte d'entrée, 0,612 contre 0,0001 sur nos deux lignes.

Sur le plan juridique, c'est l'un des services les plus légers du catalogue. Une adresse, ses coordonnées et son fuseau horaire sont des faits concernant un lieu ; aucune des vingt colonnes ne décrit une personne, et la géographie sous-jacente provient d'OpenStreetMap, une carte collaborative publique. Ce qui mérite réflexion, c'est l'entrée : si les adresses soumises sont des domiciles de clients, cette liste était une donnée personnelle avant de nous parvenir et le reste ensuite, elle doit donc être traitée en conséquence. Uniquement des sources publiquement disponibles, rien derrière une authentification, aucun traceur tiers sur la couche de données, et des exports qui s'auto-suppriment au bout de 30 jours. Vos 500 premières lignes sont gratuites et ne demandent pas de carte bancaire.