Address Validation (beta)

Classe AddressValidation

Classe google.maps.addressValidation.AddressValidation

Classe statique permettant d'accéder aux API Address Validation.

Accédez-y en appelant le const {AddressValidation} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetafetchAddressValidation
fetchAddressValidation(request)
Paramètres :
Valeur renvoyée : Promise<AddressValidation>
Valide une adresse. Consultez https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.
Betaaddress
Type : Address optional
Informations sur l'adresse elle-même, par opposition au géocode.
Betageocode
Type : Geocode optional
Informations sur l'emplacement et le lieu auxquels l'adresse a été géocodée.
Betametadata
Type : AddressMetadata optional
Autres informations utiles concernant la délivrabilité. Il n'est pas garanti que metadata soit entièrement renseigné pour chaque adresse envoyée à l'API Address Validation.
BetaresponseId
Type : string optional
UUID qui identifie cette réponse. Si l'adresse doit être validée de nouveau, cet UUID doit accompagner la nouvelle demande.
BetauspsData
Type : USPSData optional
Indicateurs de distribution supplémentaires fournis par USPS. Fourni uniquement dans les régions US et PR.
Betaverdict
Type : Verdict optional
Indicateurs de verdict global
BetatoJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Object
Convertit la classe AddressValidation en objet JSON avec les mêmes propriétés.

Interface AddressValidationRequest

Interface google.maps.addressValidation.AddressValidationRequest

Interface de requête pour BetaAddressValidation.fetchAddressValidation.
Betaaddress
Adresse en cours de validation. Les adresses non mises en forme doivent être envoyées via PostalAddress.addressLines.
BetapreviousResponseId optional
Type : string optional
Ce champ ne doit pas être défini pour la première demande de validation d'adresse. Si plusieurs demandes sont nécessaires pour valider complètement une seule adresse (par exemple, si les modifications apportées par l'utilisateur après la validation initiale doivent être revalidées), chaque demande de suivi doit remplir ce champ avec le BetaAddressValidation.responseId de la toute première réponse de la séquence de validation.
BetauspsCASSEnabled optional
Type : boolean optional
Active le mode compatible USPS CASS. Cela n'affecte que le champ BetaAddressValidation.uspsData de AddressValidation. Remarque : Pour les demandes compatibles USPS CASS concernant des adresses à Porto Rico, un PostalAddress.regionCode du address doit être indiqué comme "PR", ou un PostalAddress.administrativeArea du address doit être indiqué comme "Porto Rico" (sans tenir compte de la casse) ou "PR".

Classe Address

Classe google.maps.addressValidation.Address

Détails de l'adresse post-traitée. Le post-traitement consiste à corriger les parties mal orthographiées de l'adresse, à remplacer les parties incorrectes et à déduire les parties manquantes.

Accédez-y en appelant le const {Address} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
Betacomponents
Composants individuels de l'adresse mise en forme et corrigée, ainsi que des informations de validation. Vous y trouverez des informations sur l'état de validation des différents composants.
BetaformattedAddress
Type : string optional
Adresse post-traitée, mise en forme sur une seule ligne selon les règles de mise en forme des adresses de la région où elle se trouve.
BetamissingComponentTypes
Type : Array<string>
Types de composants qui devaient être présents dans une adresse postale au format correct, mais qui n'ont pas été trouvés dans l'entrée ET 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. Par exemple, ['street_number', 'route'] pour une entrée telle que "Boulder, Colorado, 80301, États-Unis". Pour consulter la liste des types possibles, cliquez ici.
BetapostalAddress
Type : PostalAddress optional
Adresse post-traitée représentée sous forme d'adresse postale.
BetaunconfirmedComponentTypes
Type : Array<string>
Types des composants présents dans address_components, mais dont l'exactitude n'a pas pu être confirmée. Ce champ est fourni pour des raisons pratiques : son contenu équivaut à une itération dans address_components pour trouver les types de tous les composants où BetaAddressComponent.confirmationLevel n'est pas BetaConfirmationLevel.CONFIRMED ou l'indicateur BetaAddressComponent.inferred n'est pas défini sur true. Pour consulter la liste des types possibles, cliquez ici.
BetaunresolvedTokens
Type : Array<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 cela ne ressemble pas à un numéro de rue valide.

Classe AddressComponent

Classe google.maps.addressValidation.AddressComponent

Représente un seul composant d'une adresse (par exemple, le nom de la rue ou la ville).

Accédez-y en appelant le const {AddressComponent} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetacomponentName
Type : string optional
Texte du nom du composant. Par exemple, "5e Avenue" pour un nom de rue ou "1253" pour un numéro de rue.
BetacomponentNameLanguageCode
Type : string optional
Code de langue BCP-47. Cette valeur ne sera pas présente si le nom du composant n'est pas associé à une langue, comme un numéro de rue.
BetacomponentType
Type : string optional
Type du composant d'adresse. Pour obtenir la liste des types possibles, consultez le Tableau 2 : Autres types renvoyés par le service Places.
BetaconfirmationLevel
Type : ConfirmationLevel optional
Indique le degré de certitude que le composant est correct.
Betainferred
Type : boolean
Si la valeur est "true", cela signifie que ce composant ne faisait pas partie de l'entrée, mais qu'il a été déduit pour l'adresse. Il est recommandé d'inclure ce composant pour une adresse complète.
Betareplaced
Type : boolean
Indique que le nom du composant a été remplacé par un nom complètement différent. Par exemple, remplacer un code postal incorrect par le bon code postal pour l'adresse. Il ne s'agit pas d'un changement esthétique. Le composant d'entrée a été remplacé par un autre.
BetaspellCorrected
Type : boolean
Indique une correction d'une faute d'orthographe dans le nom du composant. L'API ne signale pas toujours les changements d'une variante orthographique à une autre, par exemple "centre" à "center".
Betaunexpected
Type : boolean
Si la valeur est "true", ce composant ne doit pas être présent dans une adresse postale pour la région concernée. Il n'a été conservé que parce qu'il faisait partie de l'entrée.

Classe AddressMetadata

Classe google.maps.addressValidation.AddressMetadata

Métadonnées de l'adresse. Il n'est pas garanti que AddressMetadata soit entièrement renseigné pour chaque adresse envoyée à l'API Address Validation.

Accédez-y en appelant le const {AddressMetadata} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
Betabusiness
Type : boolean
BetapoBox
Type : boolean
Betaresidential
Type : boolean

Constantes ConfirmationLevel

google.maps.addressValidation.ConfirmationLevel constantes

Les différentes valeurs possibles indiquant le niveau de certitude que le composant est correct.

Accédez-y en appelant le const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetaCONFIRMED
BetaUNCONFIRMED_AND_SUSPICIOUS
BetaUNCONFIRMED_BUT_PLAUSIBLE

Geocode class

Classe google.maps.addressValidation.Geocode

Contient des informations sur le lieu auquel l'entrée a été géocodée.

Accédez-y en appelant le const {Geocode} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
Betabounds
Type : LatLngBounds optional
Limites du lieu géocodé.
BetafeatureSizeMeters
Type : number optional
Taille du lieu géocodé, en mètres. Il s'agit d'une autre mesure de la précision de l'emplacement géocodé, mais en termes de taille physique plutôt que de signification sémantique.
Betalocation
Type : LatLngAltitude optional
Emplacement géocodé de l'entrée.
BetaplaceId
Type : string optional
ID du lieu géocodé. Il est préférable d'utiliser Place plutôt que des adresses, des coordonnées de latitude/longitude ou des plus codes. Si vous utilisez des coordonnées pour le routage ou pour calculer des itinéraires, le point sera toujours associé à la route la plus proche de ces coordonnées. Il peut s'agir d'une route qui ne mène pas rapidement ni en toute sécurité à la destination, et qui peut ne pas se trouver à proximité d'un point d'accès à la propriété. De plus, lorsqu'un emplacement est géocodé à l'inverse, il n'est pas garanti que l'adresse renvoyée corresponde à l'adresse d'origine.
BetaplaceTypes
Type : Array<string>
Type(s) de lieu auquel l'entrée a été géocodée. Par exemple, ['locality', 'political']. La liste complète des types est disponible dans la documentation de l'API Geocoding.
BetaplusCode
Type : PlusCode optional
Plus Code correspondant à location.
BetafetchPlace
fetchPlace()
Paramètres : aucun
Valeur renvoyée : aucune
Renvoie une représentation Place de ce code géographique. Pour obtenir des informations complètes sur un lieu, vous devez appeler place.fetchFields().

Constantes de précision

google.maps.addressValidation.Granularity constantes

Les différentes granularités qu'une adresse ou un géocode peuvent avoir. Lorsqu'elles sont utilisées pour indiquer la précision d'une adresse, ces valeurs indiquent la précision avec laquelle l'adresse identifie une destination d'envoi. Par exemple, une adresse telle que "123 Main Street, Redwood City, CA, 94061" identifie un PREMISE, tandis qu'une adresse telle que "Redwood City, CA, 94061" identifie un LOCALITY. Toutefois, si nous ne parvenons pas à trouver de géocode pour "123 Main Street" à Redwood City, le géocode renvoyé peut être de granularité LOCALITY, même si l'adresse est plus précise.

Accédez-y en appelant le const {Granularity} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetaBLOCK L'adresse ou le géocode indiquent un bloc. Utilisé uniquement dans les régions où l'adressage est effectué au niveau des blocs, comme au Japon.
BetaOTHER Toutes les autres granularités, qui sont regroupées, car elles ne peuvent pas être diffusées.
BetaPREMISE Résultat au niveau du bâtiment.
BetaPREMISE_PROXIMITY Un géocode qui correspond approximativement à l'emplacement de l'adresse au niveau du bâtiment.
BetaROUTE Le géocode ou l'adresse sont précis au niveau de l'itinéraire (rue, route ou autoroute, par exemple).
BetaSUB_PREMISE Résultat au niveau inférieur à celui du bâtiment, comme un appartement.

Classe USPSAddress

Classe google.maps.addressValidation.USPSAddress

Représentation USPS d'une adresse aux États-Unis.

Accédez-y en appelant le const {USPSAddress} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
Betacity
Type : string optional
Nom de la ville.
BetacityStateZipAddressLine
Type : string optional
Ligne d'adresse contenant la ville, l'État et le code postal.
Betafirm
Type : string optional
Nom de l'entreprise.
BetafirstAddressLine
Type : string optional
Première ligne de l'adresse.
BetasecondAddressLine
Type : string optional
Deuxième ligne de l'adresse.
Betastate
Type : string optional
Code d'État à deux lettres.
Betaurbanization
Type : string optional
Nom de l'urbanisation portoricaine.
BetazipCode
Type : string optional
Le code postal, par exemple "10009".
BetazipCodeExtension
Type : string optional
Extension à quatre chiffres du code postal, par exemple "5023".

Classe USPSData

Classe google.maps.addressValidation.USPSData

Données USPS pour l'adresse. Il n'est pas garanti que USPSData soit entièrement renseigné pour chaque adresse aux États-Unis ou à Porto Rico envoyée à l'API Address Validation. Nous vous recommandons d'intégrer les champs d'adresse de sauvegarde dans la réponse si vous utilisez uspsData comme partie principale de la réponse.

Accédez-y en appelant le const {USPSData} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetaabbreviatedCity
Type : string optional
Ville abrégée.
BetaaddressRecordType
Type : string optional
Type d'enregistrement d'adresse correspondant à l'adresse saisie.
BetacarrierRoute
Type : string optional
Code de la tournée du transporteur. Code à quatre caractères composé d'un préfixe d'une lettre et d'un numéro de route à trois chiffres.
BetacarrierRouteIndicator
Type : string optional
Indicateur de tri des tarifs des itinéraires de transporteur.
BetacassProcessed
Type : boolean
Indicateur indiquant que la demande a été traitée par CASS.
Betacounty
Type : string optional
Nom du comté.
BetadeliveryPointCheckDigit
Type : string optional
Chiffre de contrôle du point de livraison. Ce nombre est ajouté à la fin du code-barres du point de livraison pour le courrier scanné mécaniquement. La somme de tous les chiffres de delivery_point_barcode, delivery_point_check_digit, du code postal et de ZIP+4 doit être divisible par 10.
BetadeliveryPointCode
Type : string optional
Code à deux chiffres du point de livraison.
BetadpvCMRA
Type : string optional
Indique si l'adresse est une CMRA (Commercial Mail Receiving Agency), c'est-à-dire une entreprise privée qui reçoit du courrier pour ses clients. Renvoie un seul caractère.
BetadpvConfirmation
Type : string optional
Valeurs possibles pour la confirmation de la DPV. Renvoie un seul caractère ou aucune valeur.
BetadpvDoorNotAccessible
Type : string optional
Indique les adresses où l'USPS ne peut pas frapper à la porte pour distribuer le courrier. Renvoie un seul caractère.
BetadpvDrop
Type : string optional
Le drapeau indique que le courrier est distribué dans un seul réceptacle sur un site. Renvoie un seul caractère.
BetadpvEnhancedDeliveryCode
Type : string optional
Indique que plusieurs codes de retour DPV sont valides pour l'adresse. Renvoie un seul caractère.
BetadpvFootnote
Type : string optional
Notes de bas de page issues de la validation des points de livraison. Plusieurs notes de bas de page peuvent être regroupées dans la même chaîne.
BetadpvNonDeliveryDays
Type : string optional
Indique que la distribution du courrier n'est pas effectuée tous les jours de la semaine. Renvoie un seul caractère.
BetadpvNonDeliveryDaysValues
Type : number optional
Entier identifiant les jours de non-diffusion. Il peut être interrogé à l'aide d'indicateurs binaires : 0x40 – Le dimanche est un jour sans livraison 0x20 – Le lundi est un jour sans livraison 0x10 – Le mardi est un jour sans livraison 0x08 – Le mercredi est un jour sans livraison 0x04 – Le jeudi est un jour sans livraison 0x02 – Le vendredi est un jour sans livraison 0x01 – Le samedi est un jour sans livraison
BetadpvNoSecureLocation
Type : string optional
Le drapeau indique que la porte est accessible, mais le colis ne sera pas déposé en raison de problèmes de sécurité. Renvoie un seul caractère.
BetadpvNoStat
Type : string optional
Indique si l'adresse est une adresse sans numéro ou une adresse active. Les adresses sans numéro de rue sont celles qui ne sont pas occupées en permanence ou celles que l'USPS ne dessert pas. Renvoie un seul caractère.
BetadpvNoStatReasonCode
Type : number optional
Indique le type NoStat. Renvoie un code de motif sous forme d'entier.
BetadpvPBSA
Type : string optional
Indique que l'adresse correspond à un enregistrement PBSA. Renvoie un seul caractère.
BetadpvThrowback
Type : string optional
Indique que le courrier n'est pas distribué à l'adresse postale. Renvoie un seul caractère.
BetadpvVacant
Type : string optional
Indique si l'adresse est vacante. Renvoie un seul caractère.
BetaelotFlag
Type : string optional
Indicateur de l'eLOT croissant/décroissant (A/D).
BetaelotNumber
Type : string optional
Numéro eLOT (Enhanced Line of Travel).
BetaerrorMessage
Type : string optional
Message d'erreur lors de 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.
BetafipsCountyCode
Type : string optional
Code FIPS du comté.
BetahasDefaultAddress
Type : boolean
Indique qu'une adresse par défaut a été trouvée, mais que des adresses plus spécifiques existent.
BetahasNoEWSMatch
Type : boolean
L'adresse de livraison peut être mise en correspondance, mais le fichier EWS indique qu'une correspondance exacte sera bientôt disponible.
BetalacsLinkIndicator
Type : string optional
Indicateur LACSLink.
BetalacsLinkReturnCode
Type : string optional
Code de retour LACSLink.
BetapmbDesignator
Type : string optional
Indicateur de conception de l'unité PMB (Private Mail Box).
BetapmbNumber
Type : string optional
Numéro de boîte postale privée (PMB, Private Mail Box).
BetapoBoxOnlyPostalCode
Type : boolean
Code postal de boîte postale uniquement.
BetapostOfficeCity
Type : string optional
Ville du bureau de poste principal.
BetapostOfficeState
Type : string optional
État du bureau de poste principal.
BetastandardizedAddress
Type : USPSAddress optional
Adresse standardisée USPS.
BetasuiteLinkFootnote
Type : string optional
Notes de bas de page indiquant qu'un enregistrement de rue ou d'immeuble correspond à des informations sur un appartement. Si une correspondance est trouvée pour le nom de l'établissement, le numéro secondaire est renvoyé.

Classe Verdict

Classe google.maps.addressValidation.Verdict

Représente l'adresse post-traitée pour l'adresse fournie.

Accédez-y en appelant le const {Verdict} = await google.maps.importLibrary("addressValidation").
 Consultez Bibliothèques de l'API Maps JavaScript.
BetaaddressComplete
Type : boolean
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 elle n'est pas définie, indique que la valeur est false. Pour en savoir plus, consultez les champs BetaAddress.missingComponentTypes, BetaAddress.unresolvedTokens ou BetaAddressComponent.unexpected.
BetageocodeGranularity
Type : Granularity optional
Informations sur la précision de Geocode. Cela peut être interprété comme la signification sémantique de la précision de l'emplacement géocodé.
BetahasInferredComponents
Type : boolean
Au moins un composant d'adresse a été inféré (c'est-à-dire ajouté) et ne figurait pas dans l'entrée. Pour en savoir plus, consultez AddressComponent.
BetahasReplacedComponents
Type : boolean optional
Au moins un composant d'adresse a été remplacé. Pour en savoir plus, consultez AddressComponent.
BetahasUnconfirmedComponents
Type : boolean
Au moins un composant d'adresse ne peut pas être classé ni validé. Pour en savoir plus, consultez AddressComponent.
BetainputGranularity
Type : Granularity optional
Précision de l'adresse input. Il s'agit du résultat de l'analyse de l'adresse saisie. Il ne fournit aucun signal de validation. Pour les signaux de validation, consultez validationGranularity.
BetavalidationGranularity
Type : Granularity optional
Niveau de précision auquel l'API peut valider l'adresse. Par exemple, un validationGranularity de PREMISE indique que tous les composants d'adresse au niveau de PREMISE et au-delà peuvent être validés.