{"_id":"59e8a8e6f40fb0001a13074f","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":35,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"category":{"_id":"56e1c96b2506700e00de6e83","version":"55faeacad0e22017005b8268","__v":38,"pages":["56e1ca17cd6a8d0e00d12163","56e1cb0fe416450e00b9e485","56e1cba3cd6a8d0e00d1216c","56e1cc1ae63f910e00e5986b","56e1d0b0cd6a8d0e00d1217f","56e1d15ce416450e00b9e4a3","56e1d23292bf640e00b55663","56e1d296bc46be0e002af287","56e1d305cd6a8d0e00d1218c","56e1d373e416450e00b9e4ab","56e1d38a92bf640e00b55669","56e1d44dbc46be0e002af28e","56e2cb174cd67e220032d655","56e2cf9c1067950e006a16c8","56e2d5ff3987d729008695a0","56e2ddea8ffe6020004c53b2","56e2df768ffe6020004c53bd","56e2e1201067950e006a16f1","56e2e3888ffe6020004c53c5","56e2e53f1067950e006a1702","56e2e9773987d729008695cf","56e2ec731bffb72b00d0562e","56e2ed25b9c88f2900864aab","56e2f0314cd67e220032d6b9","56e2f3c43987d729008695ed","56e2fc3fb9c88f2900864ad7","56e2fe0d3987d7290086960b","56e30180f1ad030e00e72fa7","56e302c228f99e2000a5ffa6","56e3040c6e602e0e00700af6","56e304c5d46bc30e007bb958","56e30650d46bc30e007bb965","56e307456e602e0e00700b08","56e3086251857d0e008e778d","56e3096251857d0e008e7796","56e30a16d46bc30e007bb973","56e30aafd46bc30e007bb97c","56e30aeb51857d0e008e779f"],"project":"55faeacad0e22017005b8265","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-10T19:22:19.658Z","from_sync":false,"order":16,"slug":"read-query-vector-services-guide","title":"Read & Query Vector Services Guide"},"user":"56267741db1eda0d001c3dbb","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-19T13:30:14.872Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":46,"body":"| Table of Contents |\n| --- |\n| [Index General Search by Term](#section-index-general-search-by-term) |\n| [Index Shape Search by Term](#section-index-shape-search-by-term) |\n\n#Index General Search by Term#\n\nIndex General Search works the same way as the standard [General Search by Term](doc:lesson-vector-services-general-searching#section-general-search-by-term).\n\n**For more information** on querying and query construction, check the [Query Syntax, Fields, and Item Type Suffixes](doc:vector-query-syntax-query-fields-and-type-suffixes) page and [Vector Services Example Query Constructions](doc:vector-services-example-query-constructions) page.\n\n##Step 1: List Vector Items OR Get Paging ID##\n\nSince the user already has an idea of what they are searching for, they can immediately begin the process of gaining the actual vector items. This process is split based on several factors. The first of which is a division based on the number of vector items to retrieve; if there are less than 1000 vector items, the user can safely run a request to simply get the vector items in one go. This request does allow the user to either retrieve the vectors with the [default fields](doc:index-query-list-vector-items-for-bounding-box-returns-default-fields), or the user can [select the fields](doc:index-query-list-vector-items-for-bounding-box-returns-selected-fields) to return.\n\nHowever, if there are more than 1000 vector items to retrieve, the user must use [paging to retrieve the results](doc:index-query-get-paging-id-for-bounding-box). The List Vector Items api call is restricted to 1000 items or less, regardless of whether the user includes the *count* parameter.\n\nFor simplicity, if the user is unsure of whether there are less than 1000 vector items to retrieve, it is best to use the paging request instead.\n\n##Step 2: Retrieve Page of Vector Items##\n\nAfter acquiring the paging ID, the user can then [begin paging requests](doc:vs-retrieve-page-of-vector-items) to retrieve all of the resulting vector items they want. Paging is the preferred method of returning vector items, and more often than not the user will need to follow both steps to acquire everything they need from the Vector Services.\n\n##Step 3: Download Vector Items##\n\nIf the user is satisfied with what they see in the retrieved vector items based on their query, the user is able to [download the vector items](doc:vs-query-download-vector-items) as json for use in other applications.\n\n**Note: There is no vector index download option at this point; user will be working with the standard download api.**\n\n\n#Index Shape Search by Term#\n\nIndex Shape Search works the same way as the standard [Shape Search by Term](doc:lesson-vector-services-shape-searching#section-shape-search-by-term).\n\n**For more information** on querying and query construction, check the [Query Syntax, Fields, and Item Type Suffixes](doc:vector-query-syntax-query-fields-and-type-suffixes) page and [Vector Services Example Query Constructions](doc:vector-services-example-query-constructions) page.\n\n##Step 1: List Vector Items OR Get Paging ID##\n\nSince the user already has an idea of what they are searching for, they can immediately begin the process of gaining the actual vector items. This process is split based on several factors. The first of which is a division based on the number of vector items to retrieve; if there are less than 1000 vector items, the user can safely run a request to simply [get the vector items in one go](doc:index-query-list-vector-items-for-shape).\n\nHowever, if there are more than 1000 vector items to retrieve, the user must use [paging to retrieve the results](doc:index-query-get-paging-id-for-shape). The List Vector Items api call is restricted to 1000 items or less, regardless of whether the user includes the *count* parameter.\n\nFor simplicity, if the user is unsure of whether there are less than 1000 vector items to retrieve, it is best to use the paging request instead.\n\n##Step 2: Retrieve Page of Vector Items##\n\nAfter acquiring the paging ID, the user can then [begin paging requests](doc:vs-retrieve-page-of-vector-items) to retrieve all of the resulting vector items they want. Paging is the preferred method of returning vector items, and more often than not the user will need to follow both steps to acquire everything they need from the Vector Services.","excerpt":"The workflow of API requests in which a user sends when using the Vector Services","slug":"lesson-vector-services-index-searching","type":"basic","title":"Lesson: Vector Services Index Searching"}

Lesson: Vector Services Index Searching

The workflow of API requests in which a user sends when using the Vector Services

| Table of Contents | | --- | | [Index General Search by Term](#section-index-general-search-by-term) | | [Index Shape Search by Term](#section-index-shape-search-by-term) | #Index General Search by Term# Index General Search works the same way as the standard [General Search by Term](doc:lesson-vector-services-general-searching#section-general-search-by-term). **For more information** on querying and query construction, check the [Query Syntax, Fields, and Item Type Suffixes](doc:vector-query-syntax-query-fields-and-type-suffixes) page and [Vector Services Example Query Constructions](doc:vector-services-example-query-constructions) page. ##Step 1: List Vector Items OR Get Paging ID## Since the user already has an idea of what they are searching for, they can immediately begin the process of gaining the actual vector items. This process is split based on several factors. The first of which is a division based on the number of vector items to retrieve; if there are less than 1000 vector items, the user can safely run a request to simply get the vector items in one go. This request does allow the user to either retrieve the vectors with the [default fields](doc:index-query-list-vector-items-for-bounding-box-returns-default-fields), or the user can [select the fields](doc:index-query-list-vector-items-for-bounding-box-returns-selected-fields) to return. However, if there are more than 1000 vector items to retrieve, the user must use [paging to retrieve the results](doc:index-query-get-paging-id-for-bounding-box). The List Vector Items api call is restricted to 1000 items or less, regardless of whether the user includes the *count* parameter. For simplicity, if the user is unsure of whether there are less than 1000 vector items to retrieve, it is best to use the paging request instead. ##Step 2: Retrieve Page of Vector Items## After acquiring the paging ID, the user can then [begin paging requests](doc:vs-retrieve-page-of-vector-items) to retrieve all of the resulting vector items they want. Paging is the preferred method of returning vector items, and more often than not the user will need to follow both steps to acquire everything they need from the Vector Services. ##Step 3: Download Vector Items## If the user is satisfied with what they see in the retrieved vector items based on their query, the user is able to [download the vector items](doc:vs-query-download-vector-items) as json for use in other applications. **Note: There is no vector index download option at this point; user will be working with the standard download api.** #Index Shape Search by Term# Index Shape Search works the same way as the standard [Shape Search by Term](doc:lesson-vector-services-shape-searching#section-shape-search-by-term). **For more information** on querying and query construction, check the [Query Syntax, Fields, and Item Type Suffixes](doc:vector-query-syntax-query-fields-and-type-suffixes) page and [Vector Services Example Query Constructions](doc:vector-services-example-query-constructions) page. ##Step 1: List Vector Items OR Get Paging ID## Since the user already has an idea of what they are searching for, they can immediately begin the process of gaining the actual vector items. This process is split based on several factors. The first of which is a division based on the number of vector items to retrieve; if there are less than 1000 vector items, the user can safely run a request to simply [get the vector items in one go](doc:index-query-list-vector-items-for-shape). However, if there are more than 1000 vector items to retrieve, the user must use [paging to retrieve the results](doc:index-query-get-paging-id-for-shape). The List Vector Items api call is restricted to 1000 items or less, regardless of whether the user includes the *count* parameter. For simplicity, if the user is unsure of whether there are less than 1000 vector items to retrieve, it is best to use the paging request instead. ##Step 2: Retrieve Page of Vector Items## After acquiring the paging ID, the user can then [begin paging requests](doc:vs-retrieve-page-of-vector-items) to retrieve all of the resulting vector items they want. Paging is the preferred method of returning vector items, and more often than not the user will need to follow both steps to acquire everything they need from the Vector Services.