Place Details

curl --request POST \
  --url https://api.example.com/place-search/details \
  --header 'Content-Type: application/json' \
  --data '
{
  "placeId": "<string>",
  "sessionToken": "<string>"
}
'

import requests

url = "https://api.example.com/place-search/details"

payload = {
    "placeId": "<string>",
    "sessionToken": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({placeId: '<string>', sessionToken: '<string>'})
};

fetch('https://api.example.com/place-search/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/place-search/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'placeId' => '<string>',
    'sessionToken' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/place-search/details"

	payload := strings.NewReader("{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/place-search/details")
  .header("Content-Type", "application/json")
  .body("{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/place-search/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "displayName": {},
  "formattedAddress": "<string>",
  "location": {}
}

POST

place-search

details

Place Details

curl --request POST \
  --url https://api.example.com/place-search/details \
  --header 'Content-Type: application/json' \
  --data '
{
  "placeId": "<string>",
  "sessionToken": "<string>"
}
'

import requests

url = "https://api.example.com/place-search/details"

payload = {
    "placeId": "<string>",
    "sessionToken": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({placeId: '<string>', sessionToken: '<string>'})
};

fetch('https://api.example.com/place-search/details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/place-search/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'placeId' => '<string>',
    'sessionToken' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/place-search/details"

	payload := strings.NewReader("{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/place-search/details")
  .header("Content-Type", "application/json")
  .body("{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/place-search/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"placeId\": \"<string>\",\n  \"sessionToken\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "displayName": {},
  "formattedAddress": "<string>",
  "location": {}
}

Overview

Resolves a placeId from Place Autocomplete to its coordinates via Google Place Details (field mask id,displayName,formattedAddress,location). Passing the interaction’s sessionToken closes the Google Autocomplete session, billing the whole typing interaction (N autocomplete calls + this one) as a single session — clients should always pass it when they have one.

Authentication

Same as autocomplete — any authenticated caller; shares the place-search rate-limit bucket (120 / 60 per 60s, user / anon).

Body Parameters

string

required

The Google placeId from an autocomplete prediction (raw, without the client-side google: namespace prefix).

string

The session token the autocomplete calls used. Optional but strongly recommended — omitting it bills the preceding autocomplete calls per-request instead of per-session.

Response

string

The canonical Google place id.

object

{ text } — the place’s display name (e.g. "Waterloo Station").

string

Formatted address string.

object

{ latitude, longitude } — note the order: this is Google’s lat/lng object, not a Mapbox-style [lng, lat] pair. The planner client (fetchGooglePlaceDetails) owns the axis swap; this contract is locked in by packages/shared/__fixtures__/google-place-details-waterloo.json and its regression test.

Example

curl -s -X POST 'https://YOUR_PROJECT.supabase.co/functions/v1/place-search/details' \
  -H 'Authorization: Bearer YOUR_PUBLISHABLE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "placeId": "ChIJq5ZP7bkEdkgRehp2VdTG7Vs", "sessionToken": "33333333-3333-4333-8333-333333333333" }'

{
  "id": "ChIJq5ZP7bkEdkgRehp2VdTG7Vs",
  "displayName": { "text": "Waterloo Station" },
  "formattedAddress": "London, UK",
  "location": { "latitude": 51.5032404, "longitude": -0.1134032 }
}

Errors

Same table as Place Autocomplete; a 502 here means the Google details call itself failed (upstream_status in the body — e.g. 404 for an unknown placeId surfaces as 502 with upstream_status: 404).

Getting Started

Routing

Places

Weather

Place Details

Overview

Authentication

Body Parameters

Response

Example

Errors

​Overview

​Authentication

​Body Parameters

​Response

​Example

​Errors

Overview

Authentication

Body Parameters

Response

Example

Errors