Package google.maps.addressvalidation.v1

string

Adresse post-traitée, formatée comme une adresse sur une seule ligne suivant les règles de mise en forme des adresses de la région où se trouve l'adresse.

PostalAddress

Adresse post-traitée représentée sous forme d'adresse postale.

AddressComponent

Liste à puces. Composants individuels de l'adresse formatée et corrigée, ainsi que les informations de validation. Vous obtenez ainsi des informations sur l'état de validation de chaque composant.

Les composants d'adresse ne sont pas ordonnés d'une manière particulière. Ne faites aucune hypothèse concernant l'ordre des composants d'adresse dans la liste.

string

Les types de composants qui étaient censés être présents dans une adresse postale au bon format, mais qui n'ont pas été trouvés dans l'entrée ET qui n'ont pas pu être déduits. Les composants de ce type ne sont pas présents dans formatted_address, postal_address ni address_components. Exemple : ['street_number', 'route'] pour une entrée telle que "Boulder, Colorado, 80301, USA". Pour consulter la liste des types possibles, cliquez ici.

string

Types de composants présents dans address_components, mais dont l'exactitude n'a pas pu être confirmée. Ce champ est fourni à titre indicatif: son contenu équivaut à une itération via address_components pour trouver les types de tous les composants pour lesquels confirmation_level n'est pas CONFIRMED ou pour lequel l'option inferred n'est pas définie sur true. Pour consulter la liste des types possibles, cliquez ici.

string

Tous les jetons de l'entrée qui n'ont pas pu être résolus. Il peut s'agir d'une entrée qui n'a pas été reconnue comme une partie valide d'une adresse (par exemple, dans une entrée telle que "123235253253 Main St, San Francisco, CA, 94105"). Les jetons non résolus peuvent ressembler à ["123235253253"], car ce n'est pas un numéro de rue valide.

ComponentName

Nom de ce composant.

string

Type de composant de l'adresse. Consultez le Tableau 2: Autres types renvoyés par le service Places pour obtenir la liste des types possibles.

ConfirmationLevel

Indique le degré de certitude que le composant est correct.

bool

Indique que le composant ne faisait pas partie de l'entrée, mais que nous l'avons déduit pour l'emplacement de l'adresse et pensons qu'il devrait être fourni pour une adresse complète.

bool

Indique une correction d'une faute d'orthographe dans le nom du composant. L'API ne signale pas toujours les changements d'orthographe d'une variante orthographique à une autre, par exemple lorsque vous remplacez "centre" par "centre". Il ne signale pas toujours les fautes d'orthographe courantes, par exemple "Amphitheatre Pkwy" au lieu de "Amphitheatre Pkwy".

bool

Indique que le nom de l'élément a été remplacé par un autre nom (par exemple, un code postal incorrect a été remplacé par un code correspondant à l'adresse). Il ne s'agit pas d'une modification esthétique. Le composant d'entrée a été remplacé par un autre.

bool

Indique un composant d'adresse qui ne devrait pas être présent dans une adresse postale pour la région donnée. Nous l'avons conservé uniquement parce qu'il faisait partie de l'entrée.

bool

Indique qu'il s'agit de l'adresse d'une entreprise. Si cette règle n'est pas configurée, elle indique que la valeur est inconnue.

bool

Indique l'adresse d'une boîte postale. Si cette règle n'est pas configurée, elle indique que la valeur est inconnue.

bool

Indique qu'il s'agit de l'adresse d'une résidence. Si cette règle n'est pas configurée, elle indique que la valeur est inconnue.

string

Texte du nom. Par exemple, "5e Avenue" pour un nom de rue ou "1253" pour un numéro de rue.

string

Code de langue BCP-47. Ce champ ne sera pas présent si le nom de l'élément n'est associé à aucune langue, telle qu'un numéro de rue.

LatLng

Emplacement géocodé de l'entrée.

Il est préférable d'utiliser des ID de lieu plutôt que d'utiliser des adresses, des coordonnées de latitude/longitude ou des codes plus codes. Lorsque vous utilisez des coordonnées lors du calcul d'un itinéraire ou d'un itinéraire en voiture, le point est toujours aligné sur la route la plus proche de ces coordonnées. Il est possible qu'elle ne permette pas d'accéder rapidement ou en toute sécurité à la destination, et qu'elle ne soit pas située à proximité d'un point d'accès à la propriété. De plus, lorsqu'un établissement est géocodé à l'envers, il n'est pas garanti que l'adresse renvoyée corresponde à l'adresse d'origine.

PlusCode

Plus code correspondant à l'élément location.

Viewport

Limites du lieu géocodé.

float

Taille du lieu géocodé, en mètres. Il s'agit là d'une autre mesure du caractère grossière du lieu géocodé, mais en termes de taille physique plutôt que sémantique.

string

PlaceID du lieu géocodé par cette entrée.

Pour en savoir plus sur les ID de lieu, cliquez ici.

string

Type(s) de lieu géocodé(s) par l'entrée. Par exemple, ['locality', 'political']. Pour consulter la liste complète des types, cliquez ici.

bool

Aperçu: Renvoyez un google.maps.addressvalidation.v1.Address en anglais. Pour en savoir plus, consultez google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

string

Code global (complet) du lieu, par exemple "9FWM33GV+HQ", qui représente une zone de 1/8000 x 1/8000 degré (environ 14 x 14 mètres).

string

Code composé du lieu, tel que "33GV+HQ, Ramberg, Norvège ", contenant le suffixe du code global et le remplacement du préfixe par le nom mis en forme d'une entité de référence.

ValidationConclusion

Obligatoire. Le résultat de la série de tentatives de validation

Si ce champ est défini sur VALIDATION_CONCLUSION_UNSPECIFIED, une erreur INVALID_ARGUMENT est renvoyée.

string

Obligatoire. ID de la réponse à laquelle ces commentaires sont destinés. Il doit s'agir de l'identifiant [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] de la première réponse d'une série de tentatives de validation d'adresse.

string

Première ligne d'adresse.

string

Nom de l'entreprise.

string

Deuxième ligne d'adresse.

string

Nom d'urbanisation portoricain

string

Ville + État + code postal.

string

Nom de la ville.

string

Code d'État à deux lettres.

string

Code postal, par exemple 10009.

string

Extension de code postal à quatre chiffres, par exemple 5023.

UspsAddress

adresse normalisée USPS.

string

Code de point de livraison à deux chiffres

string

Chiffre de contrôle du point de livraison. Ce nombre est ajouté à la fin de la valeur delivery_point_barcode pour les e-mails scannés manuellement. En additionnant tous les chiffres de delivery_point_barcode, delivery_point_check_digit, postal code et ZIP+4, vous devez obtenir un nombre divisible par 10.

string

Valeurs possibles pour la confirmation de la DPV. Renvoie un seul caractère ou aucune valeur.

• N: la validation de la DPV a échoué pour le numéro principal et les informations secondaires.
• D: l'adresse a été confirmée pour le numéro principal uniquement, et le numéro secondaire était manquant.
• S: l'adresse a été confirmée pour le numéro principal uniquement. Les informations du numéro secondaire étaient présentes, mais pas confirmées.
• Y: l'adresse a été confirmée pour le numéro principal et les numéros secondaires.
• Vide: si la réponse ne contient pas de valeur dpv_confirmation, cela signifie que l'adresse n'a pas été envoyée pour la confirmation de la DPV.

string

Notes de bas de page de la validation du point de livraison. Plusieurs notes de bas de page peuvent être enchaînées dans la même chaîne.

• AA: adresse d'entrée mise en correspondance avec le fichier ZIP+4
• A1: l'adresse d'entrée ne correspond pas au fichier ZIP+4.
• BB: mis en correspondance avec la DPV (tous les composants)
• CC: numéro secondaire sans correspondance et non requis
• C1: numéro secondaire requis, mais sans correspondance
• N1: numéro secondaire manquant dans un gratte-ciel
• M1: numéro principal manquant
• M3: numéro principal non valide
• P1: adresse d'entrée PO, RR ou numéro de boîte du centre d'aide manquant
• P3: numéro de bon de commande, numéro de demande d'enregistrement ou numéro de boîte du centre d'aide de l'adresse de saisie non valide
• F1: adresse d'entrée associée à une adresse militaire
• G1: adresse saisie correspondant à une adresse de livraison générale
• U1: adresse saisie associée à un code postal unique
• PB: adresse d'entrée mise en correspondance avec l'enregistrement PBSA
• RR: adresse confirmée avec les informations du PMB
• R1: adresse confirmée par la DPV, sans les informations du PMB
• R7: enregistrement Route R777 ou R779 de l'opérateur
• IA: adresse éclairée identifiée
• TA: numéro principal mis en correspondance en supprimant une valeur alpha à la fin.

string

Indique si l'adresse est celle d'une agence de réception de courrier commercial (CRMA, Commercial Mail Receiver Agency), c'est-à-dire une entreprise privée qui reçoit du courrier pour ses clients. Renvoie un seul caractère.

• Y: l'adresse est une CMRA
• N: l'adresse n'est pas une adresse CMRA

string

Ce lieu est-il inoccupé ? Renvoie un seul caractère.

• Y: l'adresse est vide.
• N: l'adresse n'est pas libre.

string

S'agit-il d'une adresse active ou sans statistiques ? Les adresses statistiques ne sont pas occupées en permanence ou ne sont pas desservies par l'USPS. Renvoie un seul caractère.

• Y: l'adresse n'est pas active
• N: l'adresse est active

int32

Indique le type de valeur NoStat. Renvoie un code de motif sous la forme d'un entier.

• 1 : IDA (Internal Drop Address) (adresse de dépôt interne) : adresses qui ne reçoivent pas de courrier directement de l'USPS, mais qui sont distribuées à une adresse de dépôt qui les dessert.
• 2: CDS – Adresses qui ne sont pas encore livrables. Par exemple, une nouvelle subdivision dans laquelle les lots et les numéros principaux ont été déterminés, mais où il n'existe pas encore de structure pour le nombre de personnes.
• 3: collision (adresses qui ne sont pas confirmées par la DPV).
• 4: CMZ (College, Military and Other Types) – ZIP + 4 enregistrements USPS incorporés dans les données.
• 5 : standard : les adresses ne reçoivent pas de livraison et ne sont pas comptabilisées comme des livraisons possibles.
• 6: adresse e-mail secondaire obligatoire.

string

L'indicateur indique que le courrier est distribué à un seul destinataire sur un site. Renvoie un seul caractère.

• Y: le courrier est distribué à un destinataire unique sur un site.
• N: le courrier n'est pas distribué à un destinataire unique sur un site.

string

Indique que le courrier n'est pas distribué à l'adresse postale. Renvoie un seul caractère.

• Y: le courrier n'est pas distribué à l'adresse postale.
• N: le courrier est distribué à l'adresse postale.

string

L'indicateur indique que l'envoi d'e-mails n'est pas effectué tous les jours de la semaine. Renvoie un seul caractère.

• Y: le courrier n'est pas distribué tous les jours.
• N: aucune indication que l'envoi du courrier n'est pas effectué tous les jours de la semaine.

int32

Entier identifiant les jours de non-diffusion. Il peut être interrogé à l'aide d'indicateurs de bits: 0x40 – Le dimanche est un jour de non-livraison 0x02 – Le lundi est un jour de non-livraison 0x02 – Le lundi est un jour de non-livraison 0x10 – Le mardi est un jour de non-livraison 0x08 – Le mercredi est un jour de non-livraison 0x04 – Le jeudi est un jour de non-livraison 0x02 – Le vendredi est un jour de non-livraison 0x02 – Le vendredi est un jour de non-livraison 0x02 – Le vendredi est un jour de non-livraison 0x02

string

L'indicateur indique que la porte est accessible, mais qu'aucun colis ne sera déposé pour des raisons de sécurité. Renvoie un seul caractère.

• Y: le colis ne sera pas conservé en raison de problèmes de sécurité.
• N: aucune indication que le colis ne sera pas déposé en raison de problèmes de sécurité.

string

Indique que l'adresse a été mise en correspondance avec un enregistrement PBSA. Renvoie un seul caractère.

• Y: l'adresse a été mise en correspondance avec l'enregistrement PBSA.
• N: l'adresse n'a pas été mise en correspondance avec l'enregistrement PBSA.

string

L'indicateur indique les adresses pour lesquelles USPS ne peut pas frapper à la porte pour distribuer du courrier. Renvoie un seul caractère.

• Y: la porte n'est pas accessible.
• N: aucune indication que la porte n'est pas accessible.

string

Indique que plusieurs codes DPV renvoyés sont valides pour l'adresse. Renvoie un seul caractère.

• Y: l'adresse a été confirmée pour le numéro principal et les numéros secondaires.
• N: la validation de la DPV a échoué pour le numéro principal et les informations secondaires.
• S: l'adresse a été confirmée pour le numéro principal uniquement, et les informations du numéro secondaire étaient présentes, mais pas confirmées, ou un seul alpha à la fin d'un numéro principal a été supprimé pour établir une correspondance avec la DPV et fournir des informations secondaires.
• D: l'adresse a été confirmée pour le numéro principal uniquement, et le numéro secondaire était manquant.
• R: l'adresse confirmée, mais attribuée à la route fantôme R777, R779 et USPS n'est pas fournie.

string

Code de l'itinéraire du transporteur. Code à quatre caractères composé d'une lettre de préfixe et d'un indicateur d'itinéraire à trois chiffres.

Préfixes:

• C: itinéraire de la compagnie (ou de la ville)
• R: route rurale
• H: itinéraire du contrat autoroutier
• B: section "Boîte postale"
• G: unité de diffusion générale

string

Indicateur de tri du tarif de routage du transporteur.

bool

L'adresse de livraison peut correspondre, mais le fichier EWS indique qu'une correspondance exacte sera bientôt disponible.

string

Ville du bureau de poste principal.

string

Bureau de poste principal.

string

Ville abrégée.

string

Code de comté FIPS.

string

Nom du comté.

string

Numéro eLOT (Enhanced Line of Travel).

string

Indicateur eLOT croissant/décroissant (A/D).

string

Code de retour LACSLink.

string

Indicateur LACSLink.

bool

Code postal de la boîte postale uniquement.

string

les notes de bas de page, issues de la mise en correspondance d'un enregistrement de rue ou d'un gratte-ciel avec les informations sur l'appartement ; En cas de correspondance du nom d'entreprise, le numéro secondaire est renvoyé.

• A: correspondance d'enregistrement SuiteLink, amélioration de l'adresse de l'entreprise.
• 00: aucune correspondance, l'adresse de l'établissement n'a pas été améliorée.

string

Désignation de la boîte aux lettres privée (PMB)

string

Numéro de boîte aux lettres privée (PMB)

string

Type d'enregistrement d'adresse correspondant à l'adresse d'entrée.

• F: FIRM. Il s'agit d'une correspondance avec un enregistrement d'entreprise, qui constitue le niveau de correspondance le plus précis disponible pour une adresse.
• G: DIFFUSION GÉNÉRALE. Il s'agit d'une correspondance avec un enregistrement de livraison générale.
• H: Bâtiment / Appartement. Il s'agit d'une correspondance avec un enregistrement de bâtiment ou d'appartement.
• P: POST OFFICE BOX. Il s'agit d'une correspondance avec une boîte postale.
• R: RURAL ROUTE ou HIGHWAY CONTRACT: correspond à un enregistrement de route rurale ou de contrat d'autoroute, qui peuvent tous deux être associés à des plages de numéros de boîte aux lettres.
• S (STREET RECORD) : correspondance avec un enregistrement de rue contenant une plage de numéros principal valide.

bool

Indicateur spécifiant qu'une adresse par défaut a été trouvée, mais qu'il existe des adresses plus spécifiques.

string

Message d'erreur pour la récupération des données USPS. Ce champ est renseigné lorsque le traitement USPS est suspendu en raison de la détection d'adresses créées artificiellement.

Il est possible que les champs de données USPS ne soient pas renseignés lorsque cette erreur se produit.

bool

Indicateur spécifiant que la requête a été traitée CASS.

PostalAddress

Obligatoire. Adresse en cours de validation. Les adresses non formatées doivent être envoyées via address_lines.

La longueur totale des champs de cette entrée ne doit pas dépasser 280 caractères.

Pour consulter la liste des régions couvertes, cliquez ici.

La valeur language_code de l'adresse d'entrée est réservée pour de futures utilisations et est ignorée aujourd'hui. Le résultat validé est renseigné en fonction de la langue préférée pour l'adresse donnée, telle qu'elle est identifiée par le système.

L'API Address Validation ignore les valeurs dans recipients et organization. Toutes les valeurs de ces champs seront supprimées et ne seront pas renvoyées. Veuillez ne pas les définir.

string

Ce champ doit être vide pour la première demande de validation d'adresse. Si davantage de requêtes sont nécessaires pour valider complètement une adresse unique (par exemple, si les modifications apportées par l'utilisateur après la validation initiale doivent être revalidées), chaque demande de suivi doit renseigner ce champ avec l'response_id de la toute première réponse de la séquence de validation.

bool

Active le mode compatible USPS CASS. Cela n'affecte que le champ google.maps.addressvalidation.v1.ValidationResult.usps_data de google.maps.addressvalidation.v1.ValidationResult. Remarque: Pour les requêtes utilisant USPS CASS pour des adresses à Porto Rico, un google.type.PostalAddress.region_code de l'address doit être indiqué en tant que "PR", ou un google.type.PostalAddress.administrative_area du address doit être indiqué "Porto Rico" (non sensible à la casse) ou "PR".

Nous vous recommandons d'utiliser une propriété address composée de composants ou de spécifier au moins deux valeurs google.type.PostalAddress.address_lines, où la première ligne contient le numéro et le nom de la rue, et la seconde la ville, l'État et le code postal.

LanguageOptions

Facultatif. Aperçu: cette fonctionnalité est en phase de preview (pré-DG). La compatibilité des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Permet à l'API Address Validation d'inclure des informations supplémentaires dans la réponse.

string

Facultatif. Chaîne identifiant une session Autocomplete à des fins de facturation. Doit être une chaîne au format base64 sans risque pour les URL et les noms de fichiers, avec une longueur maximale de 36 caractères ASCII. Sinon, une erreur INVALID_ARGUMENT est renvoyée.

La session commence lorsque l'utilisateur effectue une requête Autocomplete. Elle se termine lorsqu'il sélectionne un lieu et qu'un appel à Place Details ou Address Validation est effectué. Chaque session peut comporter plusieurs requêtes Autocomplete, suivies d'une requête Place Details ou Address Validation. Les identifiants utilisés pour chaque requête au sein d'une session doivent appartenir au même projet dans la console Google Cloud. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si le paramètre sessionToken est omis ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément).

Remarque: Address Validation ne peut être utilisé que dans les sessions avec l'API Autocomplete (nouvelle), et non l'API Autocomplete. Pour en savoir plus, consultez la page https://developers.google.com/maps/documentation/places/web-service/session-pricing.

ValidationResult

Résultat de la validation de l'adresse.

string

UUID qui identifie cette réponse. Si l'adresse doit être à nouveau validée, cet UUID doit accompagner la nouvelle demande.

Verdict

Options de verdict globales

Address

Informations sur l'adresse elle-même, par opposition au géocode.

Geocode

Informations sur l'emplacement et le lieu auxquels l'adresse a été géocodée.

AddressMetadata

Autres informations pertinentes sur la délivrabilité. Il n'est pas garanti que metadata soit entièrement renseigné pour chaque adresse envoyée à l'API Address Validation.

UspsData

Indicateurs de distribution supplémentaires fournis par USPS. Fourni uniquement dans les régions US et PR.

Address

Aperçu: cette fonctionnalité est en phase de preview (pré-DG). La compatibilité des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Adresse traduite en anglais.

Les adresses traduites ne sont pas réutilisables en tant qu'entrées API. Le service les fournit afin que l'utilisateur puisse utiliser sa langue maternelle pour confirmer ou refuser la validation de l'adresse fournie à l'origine.

Si une partie de l'adresse n'est pas traduite en anglais, le service la renvoie dans une autre langue utilisant l'alphabet latin. Pour savoir comment l'autre langue est sélectionnée, cliquez ici. Si une partie de l'adresse n'est pas traduite ni translittérée dans une langue utilisant l'alphabet latin, le service la renvoie dans la langue locale associée à l'adresse.

Activez cette sortie à l'aide de l'option google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Remarque: Le champ google.maps.addressvalidation.v1.Address.unconfirmed_component_types dans english_latin_address et les champs google.maps.addressvalidation.v1.AddressComponent.confirmation_level dans english_latin_address.address_components ne sont pas renseignés.

Granularity

Précision de l'adresse input. Ceci est le résultat de l'analyse de l'adresse d'entrée et ne fournit aucun signal de validation. Pour connaître les signaux de validation, consultez validation_granularity ci-dessous.

Par exemple, si l'adresse d'entrée inclut un numéro d'appartement spécifique, input_granularity sera SUB_PREMISE. Si nous ne pouvons pas faire correspondre le numéro d'appartement dans les bases de données ou si ce numéro n'est pas valide, la valeur validation_granularity sera probablement PREMISE ou inférieure.

Granularity

Niveau de précision avec lequel l'API peut entièrement validate l'adresse. Par exemple, une validation_granularity de PREMISE indique que tous les composants d'adresse au niveau PREMISE ou plus approximatif peuvent être validés.

Le résultat de la validation par composant d'adresse est disponible dans google.maps.addressvalidation.v1.Address.address_components.

Granularity

Informations sur le niveau de précision de geocode. Cela peut être interprété comme la signification sémantique du degré de précision ou de grossièreté du lieu géocodé.

Elle peut parfois différer de la valeur validation_granularity ci-dessus. Par exemple, notre base de données peut enregistrer l'existence d'un numéro d'appartement, mais ne pas avoir d'emplacement précis pour l'appartement dans un grand immeuble d'habitation. Dans ce cas, validation_granularity sera SUB_PREMISE, mais geocode_granularity sera PREMISE.

bool

L'adresse est considérée comme complète s'il n'y a pas de jetons non résolus, ni de composants d'adresse inattendus ou manquants. Si cette règle n'est pas configurée, elle indique que la valeur est false. Pour en savoir plus, consultez les champs missing_component_types, unresolved_tokens ou unexpected.

bool

Au moins un composant d'adresse ne peut être ni classé, ni validé. Consultez google.maps.addressvalidation.v1.Address.address_components pour en savoir plus.

bool

Au moins un composant d'adresse a été déduit (ajouté) qui ne figurait pas dans l'entrée. Pour en savoir plus, consultez google.maps.addressvalidation.v1.Address.address_components.

bool

Au moins un composant d'adresse a été remplacé. Pour en savoir plus, consultez google.maps.addressvalidation.v1.Address.address_components.