Destinations¶
Directory helpers over the top-level /destinations endpoint.
Obtained via tp.destinations. :meth:list returns the raw
:class:~themeparks._generated.models.DestinationsResponse; :meth:find
performs a forgiving substring lookup on slug and name so end-users can
type "Walt Disney World" and still get a match.
find ¶
Return the first destination that loosely matches query.
Matching is case-insensitive and punctuation-insensitive: both the
query and each candidate slug/name are normalized by lowercasing and
stripping non-alphanumeric characters before substring comparison. So
"Walt Disney World", "walt-disney-world", and
"waltdisneyworld" all resolve to the same destination.
The destinations list grows over time and entries can be renamed. If you need a stable reference, resolve the id once with this helper and pin that id in your code.
Asynchronous mirror of :class:DestinationsApi.
Same :meth:list / :meth:find surface, but both are coroutines and must
be awaited. See :meth:find for the loose-match semantics.
find
async
¶
Return the first destination that loosely matches query.
Matching is case-insensitive and punctuation-insensitive: both the
query and each candidate slug/name are normalized by lowercasing and
stripping non-alphanumeric characters before substring comparison. So
"Walt Disney World", "walt-disney-world", and
"waltdisneyworld" all resolve to the same destination.