The JSON response is a dictionary whose keys are the numbers from 1 to n and where each element is itself a dictionary containing the following keys :
Examples of requests:
- Address in France:
https://{SERVER_ADDRESS}/SINGLEV2/?Adresse=place%20de%20l%27%C3%A9glise
%20saint%20gervais%20rouen&Taille=38&Pays=FRA&Licence={LICENCE_CODE} - Address in the United Kingdom:
https://{SERVER_ADDRESS}/SINGLEV2/?Pays=GBR&Adresse=B1%201SB&Taille=38&NbMax=30&Version=1&Licence= {LICENCE_CODE} - Address in Belgium:
https://{SERVER_ADDRESS}/SINGLEV2/Adresse=Rue%20de%20Pi%C3%A9train%20124&Taille=38&Pays=BEL&Licence={LICENCE_CODE} - Address in the United States:
https://{{SERVER_ADDRESS}/SINGLEV2/?Pays=USA&Adresse=110%20AVENUE&Taille=
38&NbMax=30&Version=1&Licence={LICENCE_CODE}
Key | Value | France | International |
Instance | Number passed as a parameter during the call and returned in the response | STRING(3) | STRING(3) |
Province |
Region where the city is located. Type will depend on the country where the search is performed. Ex for USA: State’s 2 letter code will be sent here |
Not available | STRING(50) |
IDLocalite | Unique code for each city (Insee code for France) | STRING(20) | STRING(20) |
CodePostal | City Postal Code | STRING(10) | STRING(10) |
Localite | Name of the city | STRING(38) | STRING(50) |
SousLocalite | Used for countries other than France | Empty | STRING(50) |
Pays | Code ISO du pays | STRING(3) | STRING(3) |
LieuDit | Dependent locality if applicable | STRING(38) | Empty |
Latitude | Latitude of the address | Not available | Empty |
Longitude | Longitude of the address | Not available | Empty |
IDVoie or CodeVoie |
Unique number to identify the street | STRING(20) | STRING(20) |
Label | Label to be presented for auto-completion. The number is put between brackets if it is invalid for this street. A pipe character (|) separates the street from the postal code/city pair to simplify the formatting of the label. | STRING(255) | STRING(255) |
Region3 | County | Not available | STRING(50) |
Region2 | County | Not available | STRING(50) |
Region1 | Official regions | Not available | STRING(50) |
Region4 | Other region information | Not available | STRING(50) |
Numero | Number in the street with the number complement (bis ter etc...) | STRING (38) | STRING (38) |
Num | Number in the street with the number complement (bis ter etc...) | STRING(4) | STRING(4) |
NbNumero ou Nbnumero |
Number of numbers in the street | INTEGER(4) | INTEGER(4) |
valid_num |
1: The number exists in the street 0: The number does not exist in the street |
INTEGER(1) | Not available |
NumSeul | Number in the street without the number complement | STRING(4) | STRING(4) |
ListeNumero | List of available numbers in the street (key available when the number entered is not valid or when no number has been entered) | STRING(1024) | STRING(1024) |
TypeVoie | Street type (street, avenue, etc.) | STRING(20) | Not available |
Voie | Street name | STRING(38) | STRING(150) |
Suburb | Suburb | Not available | STRING(50) |
Complement | Additional address information | Empty | STRING(50) |
Complement2 | Additional address information 2 | Not available | STRING(50) |
Saisie | Text input (passed in parameter) used to search the street | STRING(255) | STRING(255) |
Entreprise | Company name | STRING(38) | Not available |