changedInput schema / properties / query / description
Previous value: -"Query string to search for points of interest in an area. If no query is provided, the endpoint will return general points of interest in the given area."New value: +"Query string. Shape influences the response: POI-like queries -> `results`; bare/ambiguous city names -> `cities`; address- or street-shaped queries with a geographic anchor -> `addresses` and/or `streets`. If omitted, returns general POIs in the supplied area."
changedInput schema / properties / radius / description
Previous value: -"Search radius around the supplied coordinates, in meters. If omitted, the search is performed globally."New value: +"Bias toward results closer to the supplied coordinates, in meters. NOT a hard cutoff -- the API may still return more distant results. If omitted, the search is performed globally."
addedOutput schema / properties / addresses
Added value: +{
+ "description": "Address matches. Typically populated when the query is a street + number AND is geographically anchored via `latitude`+`longitude` or a specific `location`.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "coordinates": {
+ "description": "Latitude/longitude of the address",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "name": {
+ "description": "The name of the address.",
+ "type": "string"
+ },
+ "pois": {
+ "description": "List of POIs located at this address.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "action": {
+ "additionalProperties": {},
+ "description": "The action associated with the result.",
+ "properties": {
+ "type": {
+ "description": "The type representing the action.",
+ "type": "string"
+ },
+ "url": {
+ "description": "A URL representing the action to be taken.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ "categories": {
+ "description": "List of category labels.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "contact": {
+ "additionalProperties": {},
+ "description": "The contact of the location.",
+ "properties": {
+ "email": {
+ "description": "Contact email for the business.",
+ "type": "string"
+ },
+ "telephone": {
+ "description": "Contact telephone number for the business.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "coordinates": {
+ "description": "Latitude/longitude pair for the location, when available.",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "icon_category": {
+ "description": "Suggested icon category (e.g. \"cafe\").",
+ "type": "string"
+ },
+ "id": {
+ "description": "Temporary identifier for the location, valid for ~8 hours. Can be used with brave_local_search-style endpoints to fetch additional information.",
+ "type": "string"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "opening_hours": {
+ "additionalProperties": {},
+ "description": "The opening hours of the location.",
+ "properties": {
+ "current_day": {
+ "description": "Opening hours for the current day. May contain multiple entries when the location closes and reopens during the day.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "days": {
+ "description": "Opening hours for the rest of the week. Each entry may itself be either a single day-hours object or an array of day-hours objects (when a day has multiple open/close intervals).",
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "pictures": {
+ "additionalProperties": {},
+ "description": "Pictures associated with the result.",
+ "properties": {
+ "results": {
+ "description": "Thumbnail entries for the location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "viewMoreUrl": {
+ "description": "URL where additional pictures can be viewed.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the location.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "price_range": {
+ "description": "Price classification string for the business (e.g. \"$\", \"$$\").",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "profiles": {
+ "description": "External profiles (e.g. data providers) associated with the result.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "provider_url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "URL of the upstream provider for this result. May be an empty string."
+ },
+ "rating": {
+ "additionalProperties": {},
+ "description": "The rating of the result.",
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "results": {
+ "description": "Web results related to this location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "meta_url": {
+ "additionalProperties": {},
+ "properties": {
+ "favicon": {
+ "description": "The favicon used for the URL.",
+ "type": "string"
+ },
+ "hostname": {
+ "description": "The lowercased domain name extracted from the URL.",
+ "type": "string"
+ },
+ "netloc": {
+ "description": "The network location part extracted from the URL.",
+ "type": "string"
+ },
+ "path": {
+ "description": "The hierarchical path of the URL useful as a display string.",
+ "type": "string"
+ },
+ "scheme": {
+ "description": "The protocol scheme extracted from the URL.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "scheme",
+ "netloc"
+ ],
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews": {
+ "additionalProperties": {},
+ "description": "Reviews associated with the result.",
+ "properties": {
+ "results": {
+ "description": "A list of trip advisor reviews for the entity.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "author": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "date": {
+ "description": "The date when the review was published.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A description seen in the review.",
+ "type": "string"
+ },
+ "rating": {
+ "additionalProperties": {},
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The title of the review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "description",
+ "date"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews_in_foreign_language": {
+ "description": "Any reviews available in a foreign language.",
+ "type": "boolean"
+ },
+ "viewMoreUrl": {
+ "description": "A URL to a web page where more information on the result can be seen.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "serves_cuisine": {
+ "description": "List of cuisine categories served.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "thumbnail": {
+ "additionalProperties": {},
+ "description": "The thumbnail associated with the location.",
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "timezone": {
+ "description": "IANA timezone identifier for the location.",
+ "type": "string"
+ },
+ "timezone_offset": {
+ "description": "UTC offset of the location's timezone, in minutes.",
+ "type": "number"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "location_result",
+ "description": "Result type identifier.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both",
+ "type",
+ "provider_url",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "pois_nearby": {
+ "description": "List of POIs nearby this address.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "action": {
+ "additionalProperties": {},
+ "description": "The action associated with the result.",
+ "properties": {
+ "type": {
+ "description": "The type representing the action.",
+ "type": "string"
+ },
+ "url": {
+ "description": "A URL representing the action to be taken.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ "categories": {
+ "description": "List of category labels.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "contact": {
+ "additionalProperties": {},
+ "description": "The contact of the location.",
+ "properties": {
+ "email": {
+ "description": "Contact email for the business.",
+ "type": "string"
+ },
+ "telephone": {
+ "description": "Contact telephone number for the business.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "coordinates": {
+ "description": "Latitude/longitude pair for the location, when available.",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "icon_category": {
+ "description": "Suggested icon category (e.g. \"cafe\").",
+ "type": "string"
+ },
+ "id": {
+ "description": "Temporary identifier for the location, valid for ~8 hours. Can be used with brave_local_search-style endpoints to fetch additional information.",
+ "type": "string"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "opening_hours": {
+ "additionalProperties": {},
+ "description": "The opening hours of the location.",
+ "properties": {
+ "current_day": {
+ "description": "Opening hours for the current day. May contain multiple entries when the location closes and reopens during the day.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "days": {
+ "description": "Opening hours for the rest of the week. Each entry may itself be either a single day-hours object or an array of day-hours objects (when a day has multiple open/close intervals).",
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "pictures": {
+ "additionalProperties": {},
+ "description": "Pictures associated with the result.",
+ "properties": {
+ "results": {
+ "description": "Thumbnail entries for the location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "viewMoreUrl": {
+ "description": "URL where additional pictures can be viewed.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the location.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "price_range": {
+ "description": "Price classification string for the business (e.g. \"$\", \"$$\").",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "profiles": {
+ "description": "External profiles (e.g. data providers) associated with the result.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "provider_url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "URL of the upstream provider for this result. May be an empty string."
+ },
+ "rating": {
+ "additionalProperties": {},
+ "description": "The rating of the result.",
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "results": {
+ "description": "Web results related to this location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "meta_url": {
+ "additionalProperties": {},
+ "properties": {
+ "favicon": {
+ "description": "The favicon used for the URL.",
+ "type": "string"
+ },
+ "hostname": {
+ "description": "The lowercased domain name extracted from the URL.",
+ "type": "string"
+ },
+ "netloc": {
+ "description": "The network location part extracted from the URL.",
+ "type": "string"
+ },
+ "path": {
+ "description": "The hierarchical path of the URL useful as a display string.",
+ "type": "string"
+ },
+ "scheme": {
+ "description": "The protocol scheme extracted from the URL.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "scheme",
+ "netloc"
+ ],
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews": {
+ "additionalProperties": {},
+ "description": "Reviews associated with the result.",
+ "properties": {
+ "results": {
+ "description": "A list of trip advisor reviews for the entity.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "author": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "date": {
+ "description": "The date when the review was published.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A description seen in the review.",
+ "type": "string"
+ },
+ "rating": {
+ "additionalProperties": {},
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The title of the review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "description",
+ "date"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews_in_foreign_language": {
+ "description": "Any reviews available in a foreign language.",
+ "type": "boolean"
+ },
+ "viewMoreUrl": {
+ "description": "A URL to a web page where more information on the result can be seen.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "serves_cuisine": {
+ "description": "List of cuisine categories served.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "thumbnail": {
+ "additionalProperties": {},
+ "description": "The thumbnail associated with the location.",
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "timezone": {
+ "description": "IANA timezone identifier for the location.",
+ "type": "string"
+ },
+ "timezone_offset": {
+ "description": "UTC offset of the location's timezone, in minutes.",
+ "type": "number"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "location_result",
+ "description": "Result type identifier.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both",
+ "type",
+ "provider_url",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the address.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "description": "Result is \"address\" when the result refers to an explicit street + number, but \"street\" when it refers only to the street itself.",
+ "enum": [
+ "address",
+ "street"
+ ],
+ "type": "string"
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "name",
+ "coordinates",
+ "pois",
+ "pois_nearby",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
addedOutput schema / properties / cities
Added value: +{
+ "description": "City matches for the query. Typically populated when the query is a bare or ambiguous city name (e.g. \"springfield\", \"san francisco\").",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "coordinates": {
+ "description": "Latitude/longitude of the city",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "country": {
+ "description": "ISO country code for the city",
+ "type": "string"
+ },
+ "name": {
+ "description": "Name of the city",
+ "type": "string"
+ },
+ "thumbnail": {
+ "additionalProperties": {},
+ "description": "Primary image for the city",
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "const": "city",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "name",
+ "country",
+ "coordinates",
+ "thumbnail"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
changedOutput schema / properties / location / description
Previous value: -"The resolved search-area metadata, when available."New value: +"The search area as resolved by the API (e.g. coordinates + city name). Useful for confirming the API interpreted the input as expected and for grounding follow-up queries."
changedOutput schema / properties / location / properties / coordinates / items
Previous value: -{
- "type": "number"
-}New value: +[
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+]
changedOutput schema / properties / results / description
Previous value: -"Array of points-of-interest matching the search."New value: +"Points of interest matching the search. Populated for POI-shaped queries."
addedOutput schema / properties / results / items / properties / action / description
Added value: +"The action associated with the result."
addedOutput schema / properties / results / items / properties / contact / description
Added value: +"The contact of the location."
changedOutput schema / properties / results / items / properties / coordinates / items
Previous value: -{
- "type": "number"
-}New value: +[
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+]
addedOutput schema / properties / results / items / properties / distance / description
Added value: +"Distance from the user's geolocation, if available."
addedOutput schema / properties / results / items / properties / family_friendly / description
Added value: +"Whether the result is family friendly."
addedOutput schema / properties / results / items / properties / is_source_both / description
Added value: +"Whether the result is from both local and global sources."
addedOutput schema / properties / results / items / properties / is_source_local / description
Added value: +"Whether the result is from local sources."
addedOutput schema / properties / results / items / properties / opening_hours / description
Added value: +"The opening hours of the location."
addedOutput schema / properties / results / items / properties / pictures / description
Added value: +"Pictures associated with the result."
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / alt
Added value: +{
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / bg_color
Added value: +{
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / duplicated
Added value: +{
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / height
Added value: +{
+ "description": "The height of the thumbnail.",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / logo
Added value: +{
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / original / format
Added value: +"uri"
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / theme
Added value: +{
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / properties / width
Added value: +{
+ "description": "The width of the thumbnail.",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / pictures / properties / results / items / required
Added value: +[
+ "src"
+]
addedOutput schema / properties / results / items / properties / postal_address / description
Added value: +"The postal address of the location."
addedOutput schema / properties / results / items / properties / postal_address / required
Added value: +[
+ "type",
+ "displayAddress"
+]
addedOutput schema / properties / results / items / properties / profile / description
Added value: +"The profile associated with the result."
addedOutput schema / properties / results / items / properties / provider_url / anyOf
Added value: +[
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+]
removedOutput schema / properties / results / items / properties / provider_url / type
Removed value: -"string"
addedOutput schema / properties / results / items / properties / rating / description
Added value: +"The rating of the result."
addedOutput schema / properties / results / items / properties / results / items / properties / family_friendly / description
Added value: +"Whether the result is family friendly."
addedOutput schema / properties / results / items / properties / results / items / properties / is_source_both / description
Added value: +"Whether the result is from both local and global sources."
addedOutput schema / properties / results / items / properties / results / items / properties / is_source_local / description
Added value: +"Whether the result is from local sources."
addedOutput schema / properties / results / items / properties / results / items / properties / profile / description
Added value: +"The profile associated with the result."
addedOutput schema / properties / results / items / properties / results / items / properties / url / anyOf
Added value: +[
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+]
changedOutput schema / properties / results / items / properties / results / items / properties / url / description
Previous value: -"Primary URL associated with the location."New value: +"Primary URL associated with the location. May be an empty string."
removedOutput schema / properties / results / items / properties / results / items / properties / url / type
Removed value: -"string"
changedOutput schema / properties / results / items / properties / results / items / required
Previous value: -[
- "title",
- "url"
-]New value: +[
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both"
+]
addedOutput schema / properties / results / items / properties / reviews / description
Added value: +"Reviews associated with the result."
addedOutput schema / properties / results / items / properties / thumbnail / description
Added value: +"The thumbnail associated with the location."
addedOutput schema / properties / results / items / properties / thumbnail / properties / alt
Added value: +{
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / bg_color
Added value: +{
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / duplicated
Added value: +{
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / height
Added value: +{
+ "description": "The height of the thumbnail.",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / logo
Added value: +{
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / original / format
Added value: +"uri"
addedOutput schema / properties / results / items / properties / thumbnail / properties / theme
Added value: +{
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+}
addedOutput schema / properties / results / items / properties / thumbnail / properties / width
Added value: +{
+ "description": "The width of the thumbnail.",
+ "type": "number"
+}
addedOutput schema / properties / results / items / properties / thumbnail / required
Added value: +[
+ "src"
+]
addedOutput schema / properties / results / items / properties / url / anyOf
Added value: +[
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+]
changedOutput schema / properties / results / items / properties / url / description
Previous value: -"Primary URL associated with the location."New value: +"Primary URL associated with the location. May be an empty string."
removedOutput schema / properties / results / items / properties / url / type
Removed value: -"string"
changedOutput schema / properties / results / items / required
Previous value: -[
- "title",
- "url"
-]New value: +[
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both",
+ "type",
+ "provider_url",
+ "zoom_level"
+]
addedOutput schema / properties / streets
Added value: +{
+ "description": "Street matches. Typically populated when the query is a street name AND is geographically anchored via `latitude`+`longitude` or a specific `location`.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "coordinates": {
+ "description": "Latitude/longitude of the address",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "name": {
+ "description": "The name of the address.",
+ "type": "string"
+ },
+ "pois": {
+ "description": "List of POIs located at this address.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "action": {
+ "additionalProperties": {},
+ "description": "The action associated with the result.",
+ "properties": {
+ "type": {
+ "description": "The type representing the action.",
+ "type": "string"
+ },
+ "url": {
+ "description": "A URL representing the action to be taken.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ "categories": {
+ "description": "List of category labels.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "contact": {
+ "additionalProperties": {},
+ "description": "The contact of the location.",
+ "properties": {
+ "email": {
+ "description": "Contact email for the business.",
+ "type": "string"
+ },
+ "telephone": {
+ "description": "Contact telephone number for the business.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "coordinates": {
+ "description": "Latitude/longitude pair for the location, when available.",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "icon_category": {
+ "description": "Suggested icon category (e.g. \"cafe\").",
+ "type": "string"
+ },
+ "id": {
+ "description": "Temporary identifier for the location, valid for ~8 hours. Can be used with brave_local_search-style endpoints to fetch additional information.",
+ "type": "string"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "opening_hours": {
+ "additionalProperties": {},
+ "description": "The opening hours of the location.",
+ "properties": {
+ "current_day": {
+ "description": "Opening hours for the current day. May contain multiple entries when the location closes and reopens during the day.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "days": {
+ "description": "Opening hours for the rest of the week. Each entry may itself be either a single day-hours object or an array of day-hours objects (when a day has multiple open/close intervals).",
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "pictures": {
+ "additionalProperties": {},
+ "description": "Pictures associated with the result.",
+ "properties": {
+ "results": {
+ "description": "Thumbnail entries for the location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "viewMoreUrl": {
+ "description": "URL where additional pictures can be viewed.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the location.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "price_range": {
+ "description": "Price classification string for the business (e.g. \"$\", \"$$\").",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "profiles": {
+ "description": "External profiles (e.g. data providers) associated with the result.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "provider_url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "URL of the upstream provider for this result. May be an empty string."
+ },
+ "rating": {
+ "additionalProperties": {},
+ "description": "The rating of the result.",
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "results": {
+ "description": "Web results related to this location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "meta_url": {
+ "additionalProperties": {},
+ "properties": {
+ "favicon": {
+ "description": "The favicon used for the URL.",
+ "type": "string"
+ },
+ "hostname": {
+ "description": "The lowercased domain name extracted from the URL.",
+ "type": "string"
+ },
+ "netloc": {
+ "description": "The network location part extracted from the URL.",
+ "type": "string"
+ },
+ "path": {
+ "description": "The hierarchical path of the URL useful as a display string.",
+ "type": "string"
+ },
+ "scheme": {
+ "description": "The protocol scheme extracted from the URL.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "scheme",
+ "netloc"
+ ],
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews": {
+ "additionalProperties": {},
+ "description": "Reviews associated with the result.",
+ "properties": {
+ "results": {
+ "description": "A list of trip advisor reviews for the entity.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "author": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "date": {
+ "description": "The date when the review was published.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A description seen in the review.",
+ "type": "string"
+ },
+ "rating": {
+ "additionalProperties": {},
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The title of the review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "description",
+ "date"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews_in_foreign_language": {
+ "description": "Any reviews available in a foreign language.",
+ "type": "boolean"
+ },
+ "viewMoreUrl": {
+ "description": "A URL to a web page where more information on the result can be seen.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "serves_cuisine": {
+ "description": "List of cuisine categories served.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "thumbnail": {
+ "additionalProperties": {},
+ "description": "The thumbnail associated with the location.",
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "timezone": {
+ "description": "IANA timezone identifier for the location.",
+ "type": "string"
+ },
+ "timezone_offset": {
+ "description": "UTC offset of the location's timezone, in minutes.",
+ "type": "number"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "location_result",
+ "description": "Result type identifier.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both",
+ "type",
+ "provider_url",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "pois_nearby": {
+ "description": "List of POIs nearby this address.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "action": {
+ "additionalProperties": {},
+ "description": "The action associated with the result.",
+ "properties": {
+ "type": {
+ "description": "The type representing the action.",
+ "type": "string"
+ },
+ "url": {
+ "description": "A URL representing the action to be taken.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "type": "object"
+ },
+ "categories": {
+ "description": "List of category labels.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "contact": {
+ "additionalProperties": {},
+ "description": "The contact of the location.",
+ "properties": {
+ "email": {
+ "description": "Contact email for the business.",
+ "type": "string"
+ },
+ "telephone": {
+ "description": "Contact telephone number for the business.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "coordinates": {
+ "description": "Latitude/longitude pair for the location, when available.",
+ "items": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "number"
+ }
+ ],
+ "type": "array"
+ },
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "distance": {
+ "additionalProperties": {},
+ "description": "Distance from the user's geolocation, if available.",
+ "properties": {
+ "units": {
+ "description": "The name of the unit associated with the quantity.",
+ "type": "string"
+ },
+ "value": {
+ "description": "The quantity of the unit.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "value",
+ "units"
+ ],
+ "type": "object"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "icon_category": {
+ "description": "Suggested icon category (e.g. \"cafe\").",
+ "type": "string"
+ },
+ "id": {
+ "description": "Temporary identifier for the location, valid for ~8 hours. Can be used with brave_local_search-style endpoints to fetch additional information.",
+ "type": "string"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "opening_hours": {
+ "additionalProperties": {},
+ "description": "The opening hours of the location.",
+ "properties": {
+ "current_day": {
+ "description": "Opening hours for the current day. May contain multiple entries when the location closes and reopens during the day.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "days": {
+ "description": "Opening hours for the rest of the week. Each entry may itself be either a single day-hours object or an array of day-hours objects (when a day has multiple open/close intervals).",
+ "items": {
+ "anyOf": [
+ {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "abbr_name": {
+ "description": "Short name of the day of the week (e.g. \"Mon\").",
+ "type": "string"
+ },
+ "closes": {
+ "description": "Closing time in 24h format (e.g. \"17:00\").",
+ "type": "string"
+ },
+ "full_name": {
+ "description": "Full name of the day of the week (e.g. \"Monday\").",
+ "type": "string"
+ },
+ "opens": {
+ "description": "Opening time in 24h format (e.g. \"09:00\").",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ }
+ ]
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "pictures": {
+ "additionalProperties": {},
+ "description": "Pictures associated with the result.",
+ "properties": {
+ "results": {
+ "description": "Thumbnail entries for the location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "viewMoreUrl": {
+ "description": "URL where additional pictures can be viewed.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the location.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "price_range": {
+ "description": "Price classification string for the business (e.g. \"$\", \"$$\").",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "profiles": {
+ "description": "External profiles (e.g. data providers) associated with the result.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "provider_url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "URL of the upstream provider for this result. May be an empty string."
+ },
+ "rating": {
+ "additionalProperties": {},
+ "description": "The rating of the result.",
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "results": {
+ "description": "Web results related to this location.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "description": {
+ "description": "Short description of the location (e.g. \"Plaza\", \"Theater\").",
+ "type": "string"
+ },
+ "family_friendly": {
+ "description": "Whether the result is family friendly.",
+ "type": "boolean"
+ },
+ "fetched_content_timestamp": {
+ "description": "The timestamp of the content when it was fetched.",
+ "type": "number"
+ },
+ "is_source_both": {
+ "description": "Whether the result is from both local and global sources.",
+ "type": "boolean"
+ },
+ "is_source_local": {
+ "description": "Whether the result is from local sources.",
+ "type": "boolean"
+ },
+ "language": {
+ "description": "The language of the page.",
+ "type": "string"
+ },
+ "meta_url": {
+ "additionalProperties": {},
+ "properties": {
+ "favicon": {
+ "description": "The favicon used for the URL.",
+ "type": "string"
+ },
+ "hostname": {
+ "description": "The lowercased domain name extracted from the URL.",
+ "type": "string"
+ },
+ "netloc": {
+ "description": "The network location part extracted from the URL.",
+ "type": "string"
+ },
+ "path": {
+ "description": "The hierarchical path of the URL useful as a display string.",
+ "type": "string"
+ },
+ "scheme": {
+ "description": "The protocol scheme extracted from the URL.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "scheme",
+ "netloc"
+ ],
+ "type": "object"
+ },
+ "page_age": {
+ "description": "The age of the page as a date string.",
+ "type": "string"
+ },
+ "page_fetched": {
+ "description": "The date the page was last fetched as a date string.",
+ "type": "string"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "description": "The profile associated with the result.",
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews": {
+ "additionalProperties": {},
+ "description": "Reviews associated with the result.",
+ "properties": {
+ "results": {
+ "description": "A list of trip advisor reviews for the entity.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "author": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "date": {
+ "description": "The date when the review was published.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A description seen in the review.",
+ "type": "string"
+ },
+ "rating": {
+ "additionalProperties": {},
+ "properties": {
+ "bestRating": {
+ "description": "Highest possible rating value.",
+ "type": "number"
+ },
+ "is_tripadvisor": {
+ "description": "Whether the rating originates from Tripadvisor.",
+ "type": "boolean"
+ },
+ "profile": {
+ "additionalProperties": {},
+ "properties": {
+ "img": {
+ "type": "string"
+ },
+ "long_name": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ratingValue": {
+ "description": "The current value of the rating.",
+ "type": "number"
+ },
+ "reviewCount": {
+ "description": "Number of reviews backing the rating.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "title": {
+ "description": "The title of the review.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "title",
+ "description",
+ "date"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "reviews_in_foreign_language": {
+ "description": "Any reviews available in a foreign language.",
+ "type": "boolean"
+ },
+ "viewMoreUrl": {
+ "description": "A URL to a web page where more information on the result can be seen.",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "serves_cuisine": {
+ "description": "List of cuisine categories served.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "thumbnail": {
+ "additionalProperties": {},
+ "description": "The thumbnail associated with the location.",
+ "properties": {
+ "alt": {
+ "description": "The alt text for the thumbnail.",
+ "type": "string"
+ },
+ "bg_color": {
+ "description": "The background color of the thumbnail.",
+ "type": "string"
+ },
+ "duplicated": {
+ "description": "Whether the thumbnail is duplicated.",
+ "type": "boolean"
+ },
+ "height": {
+ "description": "The height of the thumbnail.",
+ "type": "number"
+ },
+ "logo": {
+ "description": "Whether the thumbnail is a logo.",
+ "type": "boolean"
+ },
+ "original": {
+ "description": "The original URL of the image.",
+ "format": "uri",
+ "type": "string"
+ },
+ "src": {
+ "description": "The served URL of the picture thumbnail.",
+ "type": "string"
+ },
+ "theme": {
+ "description": "The theme of the thumbnail (e.g. \"light\", \"dark\").",
+ "type": "string"
+ },
+ "width": {
+ "description": "The width of the thumbnail.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "src"
+ ],
+ "type": "object"
+ },
+ "timezone": {
+ "description": "IANA timezone identifier for the location.",
+ "type": "string"
+ },
+ "timezone_offset": {
+ "description": "UTC offset of the location's timezone, in minutes.",
+ "type": "number"
+ },
+ "title": {
+ "description": "The display title of the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "location_result",
+ "description": "Result type identifier.",
+ "type": "string"
+ },
+ "url": {
+ "anyOf": [
+ {
+ "format": "uri",
+ "type": "string"
+ },
+ {
+ "const": "",
+ "type": "string"
+ }
+ ],
+ "description": "Primary URL associated with the location. May be an empty string."
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "title",
+ "url",
+ "is_source_local",
+ "is_source_both",
+ "type",
+ "provider_url",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "postal_address": {
+ "additionalProperties": {},
+ "description": "The postal address of the address.",
+ "properties": {
+ "addressLocality": {
+ "description": "The address locality or subregion associated with the location.",
+ "type": "string"
+ },
+ "addressRegion": {
+ "description": "The region associated with the location. Usually a state.",
+ "type": "string"
+ },
+ "country": {
+ "description": "The country associated with the location.",
+ "type": "string"
+ },
+ "displayAddress": {
+ "description": "The displayed address string.",
+ "type": "string"
+ },
+ "postalCode": {
+ "description": "The postal code associated with the location.",
+ "type": "string"
+ },
+ "streetAddress": {
+ "description": "The street address associated with the location.",
+ "type": "string"
+ },
+ "type": {
+ "const": "PostalAddress",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "displayAddress"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "description": "Result is \"address\" when the result refers to an explicit street + number, but \"street\" when it refers only to the street itself.",
+ "enum": [
+ "address",
+ "street"
+ ],
+ "type": "string"
+ },
+ "zoom_level": {
+ "description": "Suggested zoom level when displaying on a map.",
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "name",
+ "coordinates",
+ "pois",
+ "pois_nearby",
+ "zoom_level"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}