--- title: Search for places that match specific criteria framework: applemapsserverapi role: symbol role_heading: Web Service Endpoint path: applemapsserverapi/-v1-search --- # Search for places that match specific criteria Find places by name or by specific search criteria. ## URL GET https://maps-api.apple.com/v1/search ## Query Parameters q: The place to search for. For example, q=eiffel tower. excludePoiCategories: A comma-separated list of strings that describes the points of interest to exclude from the search results. For example, excludePoiCategories=Restaurant,Cafe. See PoiCategory for a complete list of possible values. includePoiCategories: A comma-separated list of strings that describes the points of interest to include in the search results. For example, includePoiCategories=Restaurant,Cafe. See PoiCategory for a complete list of possible values. limitToCountries: A comma-separated list of two-letter ISO 3166-1 codes of the countries to limit the results to. For example, limitToCountries=US,CA limits the search to the United States and Canada. If you specify two or more countries, the results reflect the best available results for some or all of the countries rather than everything related to the query for those countries. resultTypeFilter: A comma-separated list of strings that describes the kind of result types to include in the response. For example, resultTypeFilter=Poi. lang: The language the server should use when returning the response, specified using a BCP 47 language code. For example, for English use lang=en-US. Defaults to en-US. searchLocation: A location defined by the application as a hint. Specify the location as a comma-separated string containing the latitude and longitude. For example, searchLocation=37.78,-122.42. searchRegion: A region the app defines as a hint. Specify the region specified as a comma-separated string that describes the region in the form north-latitude,east-longitude,south-latitude,west-longitude. For example, searchRegion=38,-122.1,37.5,-122.5. userLocation: The location of the user, specified as a comma-separated string that contains the latitude and longitude. For example, userLocation=37.78,-122.42. Search may opt to use the userLocation, if specified, as a fallback for the searchLocation. searchRegionPriority: A value that indicates the importance of the configured region. enablePagination: A value that tells the server that we expect paginated results. pageToken: A value that indicates which page of results to return. includeAddressCategories: A comma-separated list of strings that describes the addresses to include in the search results. For example, includeAddressCategories=SubLocality,PostalCode. If you use this parameter, you must include address in resultTypeFilter. See AddressCategory for a complete list of possible values. excludeAddressCategories: A comma-separated list of strings that describes the addresses to exclude in the search results. For example, excludeAddressCategories=Country,AdministrativeArea. If you use this parameter, you must include address in resultTypeFilter. See AddressCategory for a complete list of possible values. ## Response Codes 200 OK: Returns a SearchMapRegion that describes a region that encloses the results, and an array of SearchResponse objects that describes the results of the search. 400 Bad Request: An ErrorResponse object that contains an error message and an array of strings that contain additional details about the error. 401 Unauthorized: An ErrorResponse object that contains an error message that indicates the Maps access token was missing or invalid, and an array of strings that contains additional details about the error. 429 : An ErrorResponse object that indicates the call exceeds the daily service call quota for the authorization token presented. The app should try again later. If your app requires a larger daily quota, submit a quota increase request form. 500 Internal Server Error: An ErrorResponse object that contains a server error message and an array of strings that describe additional details about the error. ## Discussion Discussion Example ## See Also ### Searching - [AddressCategory](applemapsserverapi/addresscategory.md) - [SearchACResultType](applemapsserverapi/searchacresulttype.md) - [SearchResultType](applemapsserverapi/searchresulttype.md) - [AlternateIdsResponse](applemapsserverapi/alternateidsresponse.md) - [AlternateIdsResponse.AlternateIds](applemapsserverapi/alternateidsresponse/alternateids.md) - [PlacesResponse](applemapsserverapi/placesresponse.md) - [PlacesResponse.PlaceLookupError](applemapsserverapi/placesresponse/placelookuperror.md) - [Search for places that meet specific criteria to autocomplete a place search](applemapsserverapi/-v1-searchautocomplete.md) - [Search for a place using an identifier](applemapsserverapi/-v1-place-:id.md) - [Search for places using mulitple identifiers](applemapsserverapi/-v1-place.md) - [Obtain a list of alternate place identifiers](applemapsserverapi/-v1-place-alternateids.md)