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

Name	Type	Description
`q` Required	string	The place to search for. For example, `q=eiffel tower`.
`excludePoiCategories` Optional	[`PoiCategory`]	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` Optional	[`PoiCategory`]	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` Optional	[string]	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` Optional	[`SearchResultType`]	A comma-separated list of strings that describes the kind of result types to include in the response. For example, `resultTypeFilter=Poi`.
`lang` Optional	`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` Optional	`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` Optional	`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` Optional	`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` Optional	string	A value that indicates the importance of the configured region.
`enablePagination` Optional	boolean	A value that tells the server that we expect paginated results.
`pageToken` Optional	string	A value that indicates which page of results to return.
`includeAddressCategories` Optional	[`AddressCategory`]	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` Optional	[`AddressCategory`]	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

Status	Reason	Type	Description
200	OK Content-Type: application/json	`SearchResponse`	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 Content-Type: application/json	`ErrorResponse`	An ErrorResponse object that contains an error message and an array of strings that contain additional details about the error.
401	Unauthorized Content-Type: application/json	`ErrorResponse`	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	Content-Type: application/json	`ErrorResponse`	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 Content-Type: application/json	`ErrorResponse`	An ErrorResponse object that contains a server error message and an array of strings that describe additional details about the error.

Search for places that match specific criteria

URL

Query Parameters

Response Codes

Discussion

Example

See Also

Searching