Skip to content

Look up a picked address

GET
/geocode/place/{placeId}
curl --request GET \
--url https://example.com/geocode/place/example \
--cookie __Host-bottle.session_token=<__Host-bottle.session_token>

One suggestion from /geocode/suggest, looked up for keeping: its lines for the form, its point and how sure that is (door: the building; street: only the street; postcode: partial street details needing a house name or number). For door and street results, token goes back with the address save as placeToken, so the point is kept without a second lookup while the lines saved are the ones picked. Postcode results have no token. 404 when it has no usable address details, 503 when the service is off or down. At most 120 a minute for a business (429).

placeId
required
string
>= 1 characters <= 2000 characters

The address

Media typeapplication/json
object
line1
required
string
line2
required
string | null
city
required
string | null
postcode
required
string | null
latitude
required
number
longitude
required
number
precision
required
string
Allowed values: door street postcode
token
string

Example

{
"precision": "door"
}

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Not a member, or without the permission this needs

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Not an address

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Too many in a minute

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

No address service here, or it is down

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}