Close Menu

amapsearch

Welcome to the documentation for the AMapSearch framework, which provides powerful search capabilities on the AMap platform. This page will guide you through setting up and using AMapSearch in your iOS application.

Installation

To start using AMapSearch, follow the steps below:

  • Install AMapSearch using Cocoapods by adding the following line to your Podfile:
pod 'AMapSearch'
  • Run pod install from the Terminal to install the framework.
  • Import AMapSearch into your project by adding the following line to the top of your source code files:
@import AMapSearch;

Getting Started

Before using AMapSearch, you need to obtain an API Key from the AMap Developer Console. Follow these steps:

  • Sign in to the AMap Developer Console.
  • Create a new application if you haven’t already.
  • Under the “Keys” tab, obtain the API Key for your application.

Once you have the API Key, you can set it in your app. To learn how, follow the instructions below.

Setting your API Key

To set your API Key, open your application’s Info.plist file and add the following entries:

  • Under the Key column, add AMapSearchAppKey.
  • In the corresponding Value field, enter your API Key obtained from the AMap Developer Console.

Now you’re ready to use AMapSearch in your app!

Using AMapSearch

AMapSearch provides several powerful features for searching locations, geocoding addresses, and reverse geocoding coordinates in your iOS app.

Search for Locations

To search for locations using AMapSearch, follow these steps:

  • Create a AMapSearchAPI instance to perform searches.
  • Set the delegate property of the search API to receive search results.
  • Call the desired search method on the search API, such as AMapPOIKeywordsSearch to search for locations based on keywords.
  • Implement the onPOISearchDone delegate method to handle the search results.
// Example code for searching locations based on keywords AMapSearchAPI *searchAPI = [[AMapSearchAPI alloc] init]; searchAPI.delegate = self; AMapPOIKeywordsSearchRequest *request = [[AMapPOIKeywordsSearchRequest alloc] init]; request.keywords = @"coffee"; [searchAPI AMapPOIKeywordsSearch:request];

Make sure to implement the necessary delegate methods to handle the search results.

Geocoding Addresses

To perform geocoding, which converts addresses into geographic coordinates, use the following steps:

  • Create a AMapSearchAPI instance to perform geocoding.
  • Set the delegate property of the search API.
  • Create a AMapGeocodeSearchRequest object and set the address property to the address you want to geocode.
  • Call the AMapGeocodeSearch method on the search API with the request object.
  • Implement the onGeocodeSearchDone delegate method to handle the geocode results.
// Example code for geocoding an address AMapSearchAPI *searchAPI = [[AMapSearchAPI alloc] init]; searchAPI.delegate = self; AMapGeocodeSearchRequest *request = [[AMapGeocodeSearchRequest alloc] init]; request.address = @"123 Main St"; [searchAPI AMapGeocodeSearch:request];

Handle the geocode results using the appropriate delegate method.

Reverse Geocoding Coordinates

To reverse geocode, which converts coordinates into addresses, use the following steps:

  • Create a AMapSearchAPI instance to perform reverse geocoding.
  • Set the delegate property of the search API.
  • Create a AMapReGeocodeSearchRequest object and set the location property to the desired coordinates.
  • Call the AMapReGoecodeSearch method on the search API with the request object.
  • Implement the onReGeocodeSearchDone delegate method to handle the reverse geocode results.
// Example code for reverse geocoding coordinates AMapSearchAPI *searchAPI = [[AMapSearchAPI alloc] init]; searchAPI.delegate = self; AMapReGeocodeSearchRequest *request = [[AMapReGeocodeSearchRequest alloc] init]; request.location = CLLocationCoordinate2DMake(39.9, 116.4); [searchAPI AMapReGoecodeSearch:request];

Implement the necessary delegate method to handle the reverse geocode results.

Conclusion

Congratulations! You’ve successfully set up and started using AMapSearch in your iOS app. You can now search locations, geocode addresses, and reverse geocode coordinates using the powerful functionalities provided by AMapSearch.