Package google.type

Index

LatLng

Objet représentant une paire latitude/longitude. Elle est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Champs
latitude

double

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

double

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

PostalAddress

Représente une adresse postale, telles que des adresses de livraison ou de paiement. Les services postaux peuvent effectuer une livraison à cette adresse, boîte postale ou autre. Ce champ n'a pas vocation à modéliser des emplacements géographiques (routes, villes ou montagnes).

Généralement, une adresse est créée via une saisie utilisateur ou lors de l'importation de données existantes, en fonction du type de processus.

Conseils pour la saisie ou la modification d'adresse : utilisez un widget d'adresse compatible avec l'internationalisation, tel que https://github.com/google/libaddressinput. Les utilisateurs ne doivent pas voir d'éléments d'interface utilisateur permettant de saisir ou de modifier des champs en dehors des pays dans lesquels ce champ est utilisé.

Pour en savoir plus sur l'utilisation de ce schéma, consultez la page https://support.google.com/business/answer/6397478.

Champs
revision

int32

Révision du schéma de PostalAddress. Toute valeur autre que 0 obligera l'API à renvoyer une erreur INVALID_ARGUMENT.
region_code

string

Facultatif. Code pays/région CLDR de l'adresse. Pour en savoir plus, consultez les pages https://cldr.unicode.org/ et https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse. Si le code de région n'est pas fourni, il sera déduit de l'adresse. Pour optimiser les performances, nous vous recommandons d'inclure le code de région si vous le connaissez. La présence de régions incohérentes ou répétées peut entraîner de mauvaises performances. Par exemple, si address_lines inclut déjà la région, ne fournissez pas à nouveau le code de région dans ce champ. Vous trouverez la liste des régions acceptées dans les questions fréquentes.
language_code

string

Le code de langue de l'adresse de saisie est réservé à une utilisation ultérieure et est ignoré pour le moment. L'API renvoie l'adresse dans la langue appropriée pour l'emplacement de l'adresse.
postal_code

string

Facultatif. Code postal de l'adresse. Tous les pays n'utilisent pas ou n'exigent pas de codes postaux, mais lorsqu'ils s'en servent, ils peuvent déclencher une validation supplémentaire avec d'autres parties de l'adresse (par exemple, validation par État/code postal aux États-Unis).
sorting_code

string

Facultatif. Code de tri supplémentaire, spécifique à chaque pays. La plupart des régions ne s'en servent pas. Lorsqu'il est utilisé, sa valeur comprend une chaîne de type CEDEX, éventuellement suivie d'un numéro (par exemple CEDEX 7), ou tout simplement un nombre représentant un "code de secteur" (Jamaïque), un "indicateur de zone de livraison" (Malawi) ou un "indicateur postal" (Côte d'Ivoire, par exemple).
administrative_area

string

Facultatif. Plus haute subdivision administrative utilisée pour les adresses postales d'un pays ou d'une région. Par exemple, il peut s'agir d'un État, d'une province, d'un oblast ou d'une préfecture. Plus précisément, pour l'Espagne, il s'agit de la province et non de la communauté autonome (par exemple, "Barcelone" et non "Catalogne"). De nombreux pays n'utilisent pas de région administrative dans leurs adresses postales. Par exemple, ce champ doit rester vide en Suisse.
locality

string

Facultatif. Fait généralement référence à la ville de l'adresse. Exemples : une "city" aux États-Unis, une "comune" en Italie, une "post town" au Royaume-Uni. Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez le champ de localité vide et utilisez address_lines.
sublocality

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, de quartiers, d'arrondissements ou de districts.
address_lines[]

string

Obligatoire. Lignes d'adresse non structurées décrivant les niveaux inférieurs d'une adresse.

Étant donné que les valeurs dans "address_lines" ne contiennent pas d'informations de type et peuvent parfois comprendre plusieurs valeurs dans un seul champ (par exemple, "Austin, TX"), il est important que l'ordre des lignes soit bien clair. L'ordre des lignes d'adresse doit correspondre à l'ordre suivi sur les enveloppes pour le pays/la région de l'adresse.

La représentation structurelle minimale autorisée pour une adresse consiste en toutes les informations placées dans address_lines. Si aucun region_code n'est fourni, la région est déduite des lignes d'adresse.

Il est recommandé de créer une adresse contenant uniquement address_lines, puis de le géocoder pour gérer les adresses complètement non structurées (plutôt que de deviner quelles parties de l'adresse correspondent à des localités ou des régions administratives).
recipients[]

string

Veuillez éviter de définir ce champ. L'API Address Validation ne l'utilise pas actuellement. À l'heure actuelle, l'API ne refuse pas les requêtes pour lesquelles ce champ est défini, mais les informations sont ignorées et ne sont pas renvoyées dans la réponse.
organization

string

Veuillez éviter de définir ce champ. L'API Address Validation ne l'utilise pas actuellement. À l'heure actuelle, l'API ne refuse pas les requêtes pour lesquelles ce champ est défini, mais les informations sont ignorées et ne sont pas renvoyées dans la réponse.