{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"API Reference","siteUrl":"https://docs.bettermile.com","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Bettermile","url":"https://bettermile.com","logo":"https://docs.bettermile.com/images/logo.png"},"description":"Worked request and response example for the Better Places geocode endpoint, with key response fields, accuracy levels, and authentication notes."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"api-reference","__idx":0},"children":["API Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/geocode"]}," endpoint accepts a raw address and returns validated coordinates plus enriched address data. For the full schemas, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/places/apis/places/places"},"children":["Places API reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request","__idx":1},"children":["Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"address\": {\n    \"street\": \"Oran-ien_str. 183b\",\n    \"number\": \"\",\n    \"postalCode\": \"10999\",\n    \"locality\": \"Berlin\",\n    \"countryCode\": \"DE\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":2},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rawAddressId\": 783549625,\n  \"naId\": 69259819,\n  \"gaId\": 157071010,\n  \"coordinates\": { \"lat\": 52.5007705, \"lng\": 13.4206488 },\n  \"streetCoordinates\": null,\n  \"entranceCoordinates\": {\n    \"points\": [\n      { \"lat\": 52.500702, \"lng\": 13.420597,\n        \"confidenceRadiusMeters\": 13.915,\n        \"coordinateId\": \"36164d48-b0cb-11f0-9021-cb6c6799d7b0\" }\n    ]\n  },\n  \"parkingCoordinates\": {\n    \"points\": [\n      { \"lat\": 52.500248, \"lng\": 13.41853,\n        \"confidenceRadiusMeters\": 8.18405154293695,\n        \"coordinateId\": \"eae2fe62-b0c9-11f0-ae11-ff7c14c158ec\" },\n      { \"lat\": 52.500901, \"lng\": 13.420638,\n        \"confidenceRadiusMeters\": 7.15566390546759,\n        \"coordinateId\": \"db09fb16-b0ca-11f0-b2a8-c146cda4fdde\" },\n      { \"lat\": 52.500852, \"lng\": 13.420825,\n        \"confidenceRadiusMeters\": 14.15,\n        \"coordinateId\": \"c264df94-b0cb-11f0-997d-45c9fc7aab62\" }\n    ]\n  },\n  \"formatted\": \"Oranienstraße 183, 10999 Berlin\",\n  \"street\": \"Oranienstraße\",\n  \"number\": \"183\",\n  \"postalCode\": \"10999\",\n  \"locality\": \"Berlin\",\n  \"subLocality\": null,\n  \"countryCode\": \"DE\",\n  \"timeframe\": null,\n  \"accuracy\": {\n    \"houseNumberFallback\": null,\n    \"houseNumberChanged\": false,\n    \"postalCodeChanged\": false,\n    \"postalCodeChangeValid\": null,\n    \"score\": 100,\n    \"level\": \"ADDRESS_POINT\"\n  },\n  \"zoneId\": \"Europe/Berlin\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The last-meter fields (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entranceCoordinates"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parkingCoordinates"]},") are populated only when Better Places is used within the Bettermile suite. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/places/resources/integration-options"},"children":["Integration Options"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-response-fields","__idx":3},"children":["Key response fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validated delivery coordinates (lat / lng)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entranceCoordinates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last-meter entrance points, each with a confidence radius."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parkingCoordinates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last-meter parking points, each with a confidence radius."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["street"]},", …"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standardized, cleaned address components."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accuracy.score"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accuracy.level"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Confidence score (0-100) and level. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"//products/places/apis/places/@2.0/places.yaml"},"children":["Geocoding Accuracy Levels"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zoneId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Time zone of the resolved location."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication--security","__idx":4},"children":["Authentication & security"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Version 1.0 authenticates with an API key in the header, version 2.0 with a Bearer token (managed in the Bettermile Backoffice)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request data is processed securely and is never exposed outside the Better Places system."]}]}]},"headings":[{"value":"API Reference","id":"api-reference","depth":1},{"value":"Request","id":"request","depth":2},{"value":"Response","id":"response","depth":2},{"value":"Key response fields","id":"key-response-fields","depth":3},{"value":"Authentication & security","id":"authentication--security","depth":2}],"frontmatter":{"title":"API Reference","rbac":{"anonymous":"read","authenticated":"read"},"seo":{"description":"Worked request and response example for the Better Places geocode endpoint, with key response fields, accuracy levels, and authentication notes.","title":"API Reference"}},"lastModified":"2026-10-28T17:26:54.707Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/places/resources/api-examples","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}