Geeft een leeg `Datatype.OverlapParams` object terug. In tegenstelling tot andere datatype
constructors, heeft deze constructor geen parameters, dus je moet
zijn eigenschappen dienovereenkomstig instellen.


OverlapParams.new

Geeft een leeg `Datatype.OverlapParams` object terug.


Het `Datatype.OverlapParams` datatype slaat parameters op voor gebruik met
`Class.WorldRoot` grensquery-functies, in het bijzonder
`Class.WorldRoot:GetPartBoundsInBox()`,
`Class.WorldRoot:GetPartBoundsInRadius()` en
`Class.WorldRoot:GetPartsInPart()`. De
`Datatype.OverlapParams.ExcludeInstances|ExcludeInstances` en
`Datatype.OverlapParams.IncludeInstances|IncludeInstances` eigenschappen slaan een
set van objecten en hun afstammelingen op die zullen worden uitgesloten en opgenomen in
de query. De `Datatype.OverlapParams.CollisionGroup` eigenschap kan een
botsingsgroep specificeren voor de grensquery-operatie.

In tegenstelling tot de meeste datatypes in Luau, kun je alle leden van
`Datatype.OverlapParams` wijzigen zonder een nieuw object te creëren, waardoor je
hetzelfde object herhaaldelijk kunt hergebruiken.


Voegt de opgegeven instanties toe aan
`Datatype.OverlapParams.FilterDescendantsInstances|FilterDescendantsInstances`.
Let op dat deze eigenschap is vervangen door
`Datatype.OverlapParams.ExcludeInstances|ExcludeInstances` en
`Datatype.OverlapParams.IncludeInstances|IncludeInstances` die moeten worden
gebruikt voor nieuw werk.


OverlapParams:AddToFilter

instances

Een instantie of een array met instanties om toe te voegen.


Voegt de opgegeven instanties toe aan
`Datatype.OverlapParams.FilterDescendantsInstances|FilterDescendantsInstances`.


OverlapParams

Een optionele array van instanties waarvan de afstammelingen zullen worden uitgesloten van de
query. Deze eigenschap kan gelijktijdig worden gebruikt met
`Datatype.OverlapParams.IncludeInstances|IncludeInstances` om gemengde filtering mogelijk te maken, bijvoorbeeld door een grote map op te nemen maar specifieke kindinstanties uit te sluiten. Als een instantie zowel aan een uitsluit- als een opnamefilter voldoet, hebben uitsluitingen voorrang op opnames.


OverlapParams.ExcludeInstances

Een optionele array van instanties waarvan de afstammelingen zullen worden uitgesloten van de
query.


Een optionele array van instanties waarvan de afstammelingen zullen worden opgenomen in de
query. Deze eigenschap kan gelijktijdig worden gebruikt met
`Datatype.OverlapParams.ExcludeInstances|ExcludeInstances` om gemengde filtering mogelijk te maken. Als een instantie zowel aan een uitsluit- als een opnamefilter voldoet, hebben uitsluitingen voorrang op opnames.

Het instellen van `IncludeInstances` op `nil` versus een lege array (`{}`) heeft
tegenovergestelde effecten. `IncludeInstances = nil` is de meest permissieve filter
(incluseert alles), terwijl `IncludeInstances = {}` de meest
restrictieve filter is (sluit alles uit).


OverlapParams.IncludeInstances

Een optionele array van instanties waarvan de afstammelingen zullen worden opgenomen in de
query.


Het maximale aantal onderdelen dat door de query moet worden teruggegeven. De standaardwaarde
van nul (`0`) vertegenwoordigt geen limiet.


OverlapParams.MaxParts

Het maximale aantal onderdelen dat door de query moet worden teruggegeven.


Specificeert een botsingsgroep voor de operatie. Onderdelen in botsingsgroepen
waarvan is ingesteld dat ze **niet** met deze groep botsen, worden genegeerd. Als deze
eigenschap wordt weggelaten, gaat de operatie uit van de **Standaard** botsingsgroep.


OverlapParams.CollisionGroup

De botsingsgroep die voor de operatie wordt gebruikt.


Verhoogt het volume van de grensquery-operatie licht, beperkt tussen `0` en `0.05` studs.


OverlapParams.Tolerance

Verhoogt het volume van de grensquery-operatie licht.


Deze eigenschap, als `true`, zorgt ervoor dat de grensquery-operatie de
waarde van een gekruist onderdeel's `Class.BasePart.CanCollide` gebruikt ten gunste van zijn
`Class.BasePart.CanQuery` waarde bij het bepalen of dat onderdeel is
opgenomen in de array van ruimtelijke queryresultaten.


OverlapParams.RespectCanCollide

Bepaalt of de grensquery-operatie de waarde van een onderdeel's
`Class.BasePart.CanCollide` eigenschap boven zijn
`Class.BasePart.CanQuery` waarde beschouwt.


Wanneer ingeschakeld, negeert de query alle botsingseigenschappen van onderdelen en
voert een brute-force controle uit op elk onderdeel. Dit zal de
prestatie negatief beïnvloeden en mag niet worden gebruikt in live ervaringen.


OverlapParams.BruteForceAllSlow

Wanneer ingeschakeld, negeert de query alle botsingseigenschappen van onderdelen en
voert een brute-force controle uit op elk onderdeel.


Een array van objecten waarvan de afstammelingen worden gebruikt bij het filteren van kandidaten.
Let op dat deze eigenschap is vervangen door
`Datatype.OverlapParams.ExcludeInstances|ExcludeInstances` en
`Datatype.OverlapParams.IncludeInstances|IncludeInstances` die moeten worden
gebruikt voor nieuw werk.


OverlapParams.FilterDescendantsInstances

Een array van objecten waarvan de afstammelingen worden gebruikt bij het filteren van kandidaten.


Bepaalt of de
`Datatype.OverlapParams.FilterDescendantsInstances|FilterDescendantsInstances`
array wordt gebruikt als een uitsluit- of opname lijst. Let op dat deze eigenschap is
vervangen door
`Datatype.OverlapParams.ExcludeInstances|ExcludeInstances` en
`Datatype.OverlapParams.IncludeInstances|IncludeInstances` die moeten worden
gebruikt voor nieuw werk.


OverlapParams.FilterType

Bepaalt of de
`Datatype.OverlapParams.FilterDescendantsInstances|FilterDescendantsInstances`
array wordt gebruikt als een uitsluit- of opname lijst.


Slaat parameters op die worden gebruikt in functies voor grensquery's.


/reference/engine/datatypes/OverlapParams.yaml

Luau

{any}

Data Type

Instance

Een object dat verbonden functies uitvoert bij een specifieke gebeurtenis.

RBXScriptSignal

Gebruikt in een `Datatype.RaycastParams` object om te bepalen hoe zijn `Datatype.RaycastParams.FilterDescendantsInstances|FilterDescendantsInstances` lijst zal worden gebruikt.

Enum

Enum.RaycastFilterType

Gegevenstype met een waarde van ofwel true of false.

boolean

number

Een reeks karakters, zoals letters, cijfers en symbolen.

string

Ervaringen

Avatar

Assets

Voorbeelden en projecten

Engine-API

Open Cloud-API

Studio

Analytics

Platform

Tutorials

Makerprogramma's

Onderwijs

Meer informatie

Deze methode is asynchroon en retourneert een 'Bewerking', die de huidige status van de bewerking weergeeft. Deze bevat een eindpuntpad dat je kunt opvragen om het daadwerkelijke antwoord en de bijbehorende metadata te verkrijgen. Zie de [documentatie]({longRunningOperationsLink}) over langlopende bewerkingen voor meer informatie. 

De volgende secties beschrijven de antwoord- en metadata-objecten die worden verstrekt wanneer een bewerking is voltooid.

Bèta-eindpunten zijn klaar voor openbaar gebruik. Ingrijpende wijzigingen zijn mogelijk, maar komen zelden voor.

Deze Open Cloud-documentatiepagina's worden op 31 maart 2026 verwijderd. Op dat moment word je automatisch doorgestuurd naar de nieuwe Open Cloud-documentatie. {linkStart}Meer informatie{linkEnd}

Deze oude Open Cloud-pagina's worden op 31 maart 2026 verwijderd en doorgestuurd. {linkStart}Meer informatie{linkEnd}

Experimentele eindpunten zijn klaar voor openbaar gebruik, maar kunnen af en toe ingrijpende wijzigingen ondergaan naarmate het API-contract wordt afgerond.

Dit eindpunt kan in de ervaring worden aangeroepen via {httpServiceLinkStart}HttpService{httpServiceLinkEnd} met een API-sleutel.

Dit veld kan worden ingesteld bij het maken van een bron, maar mag niet worden gewijzigd door latere verzoeken.

Deze velden kunnen worden ingesteld bij het maken van een bron, maar mogen niet worden gewijzigd door latere verzoeken.

Dit veld kan worden verstrekt in verzoeken, maar wordt nooit opgenomen in antwoorden.

Verouderde verificatiemethode. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Per API-sleutel: {maxInPeriod} verzoeken elke {periodInSeconds} seconden per IP-adres

Vereist geen verificatie om aan te roepen. Heeft doorgaans aanzienlijk lagere snelheidslimieten. Geef altijd de voorkeur aan het gebruik van een API-sleutel of OAuth 2.0 wanneer beschikbaar.

Voor elke groepering hoeft slechts één van de volgende velden in het schema te worden opgegeven, de overige kunnen worden uitgesloten.

Je kunt je op elk moment weer aanmelden. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de oude documenten. {linkStart}Geef feedback.{linkEnd}

Je kunt je op elk moment afmelden. Dan word je teruggestuurd naar de oude referentiepagina's. {linkStart}Geef feedback.{linkEnd}

Je bekijkt de vernieuwde documenten. {linkStart}Geef feedback.{linkEnd}

Dit veld kan worden ingesteld voor antwoorden, maar wordt genegeerd in verzoeken.

Opmerking: snelheidslimieten kunnen lager zijn tijdens perioden met veel verkeer. Bepaalde eindpunten hebben aanvullende snelheidslimieten. [Meer informatie over snelheidslimieten]({link}).

{limit} verzoeken per dag voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per uur voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per seconde voor alle API-sleutels van een gebruiker of groep

{limit} verzoeken per minuut per eigenaar van API-sleutel

{limit} verzoeken per dag per app-gebruiker

{limit} verzoeken per uur per app-gebruiker

{limit} verzoeken per minuut per app-gebruiker

{limit} verzoeken per seconde per app-gebruiker

{limit} verzoek(en) per seconde per eigenaar van API-sleutel

Het bereik bepaalt welke toestemmingen je inloggegevens hebben. Je inloggegevens hebben alleen toegang tot de eindpunten die worden ondersteund door het bereik dat je hebt geselecteerd.

Stabiele eindpunten zijn productieklaar en zullen tijdens hun levensduur bijna nooit ingrijpende wijzigingen ondergaan.

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts}

Met dit doel kun je de toegang van je sleutel beperken tot geselecteerde {requiredParts} en {optionalParts}

Doeltypen worden gebruikt om de bronnen te beperken waarvoor je inloggegevens toegang hebben. Alleen de geselecteerde bronnen kunnen worden gebruikt, zelfs als je account toegang heeft tot aanvullende bronnen. Het is mogelijk dat een bepaald bereik geen doelonderdelen heeft. In deze gevallen kunnen al je relevante bronnen worden gebruikt. 

Het universele onderdeel op het hoogste niveau hoeft niet te worden geselecteerd voor API-sleutels die eigendom zijn van de gebruiker. In dit geval heeft je API-sleutel toegang tot al je ervaringen die eigendom zijn van gebruikers en ervaringen die eigendom zijn van groepen waarvoor je de juiste groepsrechten hebt.

'Probeer het uit' wordt nog niet ondersteund voor eindpunten waarvoor een API-sleutel of OAuth 2.0-verificatie vereist is

Cookie-authenticatie is uitgeschakeld voor bewerkingen met een hoog risico om veiligheidsredenen.

Eindpunten met kritiek risico zijn uiterst gevoelig en 'Probeer het uit' is uitgeschakeld om veiligheidsredenen

Opmerking: authenticatieheaders zijn niet opgenomen in dit codevoorbeeld. Mogelijk moet je een authenticatieheader toevoegen om deze opdracht te kunnen uitvoeren.

Dit is een eindpunt met een hoog risico dat kritieke gegevens kan wijzigen of verwijderen. Wees uiterst voorzichtig bij het testen.

Dit API-eindpunt is geclassificeerd als HOOG RISICO en kan van invloed zijn op live gegevens of gebruikersaccounts.

Geverifieerde verzoeken aan API's met een hoog risico kunnen wijzigingen aanbrengen die niet ongedaan kunnen worden gemaakt. Controleer de parameters van je verzoek zorgvuldig voordat je verder gaat.

Dit is een eindpunt met een laag risico dat gegevens ophaalt. Dit is over het algemeen veilig om te testen.

Dit is een eindpunt met een gemiddeld risico dat gegevens wijzigt. Test voorzichtig met niet-kritieke accounts, aangezien wijzigingen permanent kunnen zijn.

Plak hier nooit tekst uit andere bronnen en stuur nooit informatie van deze pagina naar anderen om je account veilig te houden.

Je staat op het punt live API-eindpunten te testen met de daadwerkelijke inloggegevens van je account.

Ga alleen verder als je de implicaties begrijpt van de API-oproepen die je wilt uitvoeren. Lees de API-documentatie zorgvuldig door voordat je gaat testen.

API-oproepen worden gedaan met behulp van je geverifieerde sessie

Dit zijn echte API-oproepen die van invloed kunnen zijn op je account of gegevens

Snelheidslimieten en andere API-beperkingen zijn van toepassing

Sommige bewerkingen kunnen gegevens wijzigen of verwijderen

Dit eindpunt is vervangen door deze aanbevolen alternatieve eindpunten:

Het volgend bereik is vereist om dit eindpunt aan te roepen. Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer 
informatie over het genereren van de juiste sleutels.

Raadpleeg [API-sleutels beheren]({apiKeyReferenceDocLink}) voor meer informatie over het genereren van sleutels.

De volgende eindpunten zijn beschikbaar op paden ten opzichte van de basis-URL.

Deze string is opgemaakt als een [FieldMask](/cloud/reference/types#fieldmask).

Een JSON-waarde kan 'null', 'boolean', 'string', 'number', 'array' of 'object' zijn.

Het volgende bereik is vereist om je OAuth 2.0-applicatie dit eindpunt te laten gebruiken. Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

Raadpleeg [App-registratie en -beoordeling]({oauth2ReferenceDocLink}) voor meer informatie over het registreren van een OAuth 2.0-applicatie.

De volgende objecten beschrijven payloads die worden geaccepteerd of geretourneerd. Raadpleeg elk afzonderlijk eindpunt voor meer informatie over wanneer deze objecten worden gebruikt.

Het volgende bereik is vereist om dit eindpunt aan te roepen.

Bronpaden

Deze string is opgemaakt als een [Tijdstempel](/cloud/reference/types#timestamp).

Niet aanbevolen

Je bekijkt de vernieuwde Open Cloud-referentie.

Je hebt je afgemeld voor de nieuwe Open Cloud-referentie.

Bekijk je factureringsaccounts voor advertenties.

Verleent toegang om factureringsaccounts te configureren en advertentietegoed te kopen.

Bekijk je advertentiecampagnes en hun prestaties.

Je advertentiecampagnes maken, bijwerken en beheren.

Hiermee kun je informatie over je assets bekijken.

Hiermee kun je assets uploaden naar en bijwerken op Roblox.

Hiermee kun je assetmachtigingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je assettoestemmingen verlenen aan alle onderwerpen (inclusief groepen en ervaringen) en assets waartoe je account toegang heeft.

Hiermee kun je namens jou de status en resultaten van taken voor automatische instelling van avatars bekijken.

Hiermee kun je namens jou taken voor automatische instelling van avatars maken en beheren.

Geeft de mogelijkheid om badges van de gebruiker bij te werken.

Hiermee kun je informatie over je commerciële items bekijken.

Hiermee kun je wijzigingen aanbrengen in je gesynchroniseerde commerciële items.

Hiermee kun je informatie over je Connecties met handelaren bekijken.

Hiermee kun je je connecties met handelaren bewerken.

Hiermee kun je informatie over je Creatorwinkel-producten bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel bekijken.

Hiermee kun je informatie over opgeslagen items in je Creatorwinkel wijzigen.

Geeft toegang om namens jou gegevensopslagplaatsen te maken.

Geeft toegang om namens jou gegevensopslagplaatsen te verwijderen.

Geeft toegang om een lijst met gegevensopslagplaatsen te lezen.

Geeft toegang om een snapshot van je gegevensopslagplaatsen te maken.

Geeft toegang om items in je gegevensopslagplaatsen te maken.

Geeft toegang om specifieke items te markeren voor verwijdering.

Geeft toegang om de items van je gegevensopslag te vermelden.

Geeft toegang om specifieke items in je gegevensopslagplaatsen te lezen.

Geeft toegang om de waarde, attributen en gebruikers van een item bij te werken.

Geeft toegang om revisies van de items van je gegevensopslag te verwijderen.

Geeft toegang om revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om gelezen revisies van de items van je gegevensopslag te vermelden.

Geeft toegang om de configuratiegegevens van de ontwikkelaarsproducten van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de Developer Products van de geautoriseerde gebruiker te bewerken.

Hiermee kun je informatie over de omgevingen van je universum bekijken.

Hiermee kun je de omgevingen van je universum bewerken.

Geeft toegang om de configuratiegegevens van de game passes van de geautoriseerde gebruiker te bekijken.

Geeft toegang om de game passes van de geautoriseerde gebruiker te bewerken.

Geeft toegang om informatie over de communityforums voor je account te bekijken.

Geeft toegang om informatie over de communityforums voor je account te beheren.

Hiermee kun je informatie over je community's bekijken.

Hiermee kun je lidmaatschapsverzoeken voor de community en rolwijzigingen van lager gerangschikte communityleden beheren voor je account.

Hiermee kun je de eigenschapsgegevens van een instantie bekijken.

Hiermee kun je de property-gegevens van instanties wijzigen (momenteel alleen ondersteuning voor scripts).

Hiermee kun je informatie over je inventaris bekijken.

Geeft toegang om gebruikersassets te beheren.

Geeft toegang om je badges te beheren en Robux uit te geven.

Geeft toegang om de badges van de geautoriseerde gebruiker bij te werken.

Geeft toegang om je ontwikkelaarsproducten te beheren.

Geeft toegang om informatie te lezen over de ervaringen waarvoor je meldingen hebt ingeschakeld.

Geeft toegang om namens jou meldingen voor ervaringen in of uit te schakelen.

Geeft toegang om je community's te beheren.

Geeft toestemming om communitygegevens te lezen.

Verleent toestemmingen voor communitybeheer.

Geeft toegang om je lokalisatietabellen te lezen en te schrijven

Geeft toegang om teamsamenwerking te beheren voor alle ervaringen die je bezit.

Geeft toegang om je ervaringen en bepaalde informatie die aan je ervaringen is gekoppeld (bijv. lokalisatie-informatie) te beheren.

Geeft toegang om de lokalisatie-informatie van je ervaringen te lezen.

Geeft toegang om de lokalisatievoorkeuren van je ervaringen te wijzigen.

Geeft toegang om je gebruikersaccount te beheren.

Geeft toegang om de lokalisatievoorkeuren van de gebruiker te wijzigen.

Hiermee kun je de status, logs en resultaten van Luau-uitvoeringstaken voor de bijbehorende plaats bekijken.

Hiermee kun je nieuwe Luau-uitvoeringstaken voor de bijbehorende plaats maken.

Geeft toegang om asynchroon alle gegevensstructuren in het universum te flushen.

Geeft toegang om nieuwe wachtrijitems te maken.

Geeft toegang om gelezen items vooraan in de wachtrij te negeren.

Geeft toegang tot gelezen items vooraan in de wachtrij.

Geeft toegang om je geheugenopslagitems te lezen.

Geeft toegang om kaartitems te maken, bij te werken en te verwijderen.

Dit geeft de mogelijkheid om namens gebruikers berichten te publiceren.

Hiermee kun je meldingen vanuit je ervaring naar gebruikers sturen.

(Verouderd) Geeft toegang om een lijst met items in een genummerde gegevensopslag te lezen.

(Verouderd) Geeft toegang om een nieuw item in een genummerde gegevensopslag te maken.

Geeft toegang om items uit een genummerde gegevensopslag te vermelden.

Geeft toegang om items in een genummerde gegevensopslag te maken.

Hiermee kun je geheimen vermelden die aan je ervaring zijn gekoppeld.

Hiermee kun je geheimen maken en bijwerken die aan je ervaring zijn gekoppeld.

Met deze toestemming kun je een evaluatietaak indienen en het resultaat van de taak bekijken.

Geeft toegang om informatie over je abonnementsproducten te lezen.

Hiermee kun je namens jou informatie over miniaturen lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te lezen.

Geeft de mogelijkheid om analytics-waarschuwingen te maken of te wijzigen.

Geeft de mogelijkheid om game analytics te lezen.

Geeft de mogelijkheid om bronnen met betrekking tot game analytics te schrijven.

Geeft de mogelijkheid om plaatsinformatie te lezen.

Geeft de mogelijkheid om plaatsinformatie te bewerken.

Geeft toegang om nieuwe versies van ervaringen op Roblox te publiceren.

Hiermee kun je de miniaturen en de bijbehorende personalisatie-instellingen voor je ervaringen lezen.

Hiermee kun je de miniaturen uploaden en verwijderen en de bijbehorende personalisatie-instellingen voor je ervaringen beheren.

Geeft de mogelijkheid om informatie over ervaringen te lezen.

Geeft toegang om de ervaringen van de geautoriseerde gebruiker te bewerken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bekijken.

Hiermee kun je de gebruikersbeperkingen in de ervaring bewerken.

Hiermee kun je meldingen bekijken die naar je account zijn gestuurd.

Geeft de mogelijkheid om de premium- en geverifieerde status van de gebruiker te lezen.

Hiermee kun je de sociale media-accounts van de geautoriseerde gebruiker bekijken.

Geeft de mogelijkheid om game-evenementen te lezen.

Geeft de mogelijkheid om game-evenementen te bewerken.

Dit schakelt de Single Sign-On-functionaliteit in.

Dit geeft toegang om je profielinformatie te lezen.

Samenvatting