The /geocode endpoint accepts a raw address and returns validated coordinates plus enriched address data. For the full schemas, see the Places API reference.
{
"address": {
"street": "Oran-ien_str. 183b",
"number": "",
"postalCode": "10999",
"locality": "Berlin",
"countryCode": "DE"
}
}Even a poorly formatted address, such as one with a typo, a missing house number, or a lowercased street, is normalized to a clean, standard result.
{
"rawAddressId": 783549625,
"naId": 69259819,
"gaId": 157071010,
"coordinates": { "lat": 52.5007705, "lng": 13.4206488 },
"streetCoordinates": null,
"entranceCoordinates": {
"points": [
{ "lat": 52.500702, "lng": 13.420597,
"confidenceRadiusMeters": 13.915,
"coordinateId": "36164d48-b0cb-11f0-9021-cb6c6799d7b0" }
]
},
"parkingCoordinates": {
"points": [
{ "lat": 52.500248, "lng": 13.41853,
"confidenceRadiusMeters": 8.18405154293695,
"coordinateId": "eae2fe62-b0c9-11f0-ae11-ff7c14c158ec" },
{ "lat": 52.500901, "lng": 13.420638,
"confidenceRadiusMeters": 7.15566390546759,
"coordinateId": "db09fb16-b0ca-11f0-b2a8-c146cda4fdde" },
{ "lat": 52.500852, "lng": 13.420825,
"confidenceRadiusMeters": 14.15,
"coordinateId": "c264df94-b0cb-11f0-997d-45c9fc7aab62" }
]
},
"formatted": "Oranienstraße 183, 10999 Berlin",
"street": "Oranienstraße",
"number": "183",
"postalCode": "10999",
"locality": "Berlin",
"subLocality": null,
"countryCode": "DE",
"timeframe": null,
"accuracy": {
"houseNumberFallback": null,
"houseNumberChanged": false,
"postalCodeChanged": false,
"postalCodeChangeValid": null,
"score": 100,
"level": "ADDRESS_POINT"
},
"zoneId": "Europe/Berlin"
}The last-meter fields (entranceCoordinates, parkingCoordinates) are populated only when Better Places is used within the Bettermile suite. See Integration Options.
| Field | Description |
|---|---|
coordinates | Validated delivery coordinates (lat / lng). |
entranceCoordinates | Last-meter entrance points, each with a confidence radius. |
parkingCoordinates | Last-meter parking points, each with a confidence radius. |
formatted, street, … | Standardized, cleaned address components. |
accuracy.score, accuracy.level | Confidence score (0-100) and level. See Geocoding Accuracy Levels. |
zoneId | Time zone of the resolved location. |
- Version 1.0 authenticates with an API key in the header, version 2.0 with a Bearer token (managed in the Bettermile Backoffice).
- Request data is processed securely and is never exposed outside the Better Places system.