place_card
A place the user can go to: open now, how far, and the way there.
Somewhere to go. place_card shows a place the user can get to — the store with the shoe in stock, the nearest branch or ATM, the pharmacy on duty, a venue — with its address, how far it is, whether it is open now and until when, and the way there.
Re-rendered in the browser from the SDK’s own scales. Not a screenshot.
Directions are built by the SDK from the coordinates (or the address), as an Apple Maps or Google Maps link handed to the maps app; the model never writes the link. Call opens the dialler. On an answer page the card opens into its detail, with the week's hours.
What the server checks
The address, the phone and the coordinates have to be exactly what one of your actions returned in the conversation: a place the user walks to cannot come from the knowledge base or the model's memory. A card that fails is shown as its fallback_text.
Props
Every block also carries type and a required fallback_text of 1 to 300 characters.
| Prop | Type | Required | Constraints |
|---|---|---|---|
name | string | Yes | 1 to 80 characters. |
address | string | Yes | 1 to 160 characters. |
lat | number | No | -90 to 90. |
lng | number | No | -180 to 180. |
distance_label | string | No | Up to 20 characters. |
open_now | boolean | No | None |
hours_today | string | No | Up to 40 characters. |
hours_week | array | No | Up to 7 entries. |
hours_week[].day | string | Yes | 1 to 12 characters. |
hours_week[].hours | string | Yes | 1 to 40 characters. |
phone | string | No | 3 to 32 characters. |
rating | number | No | 0 to 5. |
rating_count | integer | No | 0 to 9,007,199,254,740,991. |
image_url | string | No | None |
directions | boolean | No | None |
website | string | No | None |