Get Started Contact sales

GooglePlaces Framework Reference

  • GMSPlacesErrorCode is an enum representing error codes for the Google Maps Places API for iOS.

  • These error codes indicate issues such as network problems, server errors, invalid API keys, usage limits, and more.

  • Each error code has a corresponding constant value in both Swift and Objective-C.

  • Detailed information on resolving specific errors, including links to relevant documentation, is provided with each error code.

  • Developers should refer to the documentation and error messages for troubleshooting and solutions.

GMSPlacesErrorCode

enum GMSPlacesErrorCode : NSInteger {}

Error codes for kGMSPlacesErrorDomain.

  • Something went wrong with the connection to the Places API server.

    Declaration

    Swift

    case networkError = -1

    Objective-C

    kGMSPlacesNetworkError = -1

  • The Places API server returned a response that we couldn’t understand.

    If you believe this error represents a bug, please file a report using the instructions on our community and support page.

    Declaration

    Swift

    case serverError = -2

    Objective-C

    kGMSPlacesServerError = -2

  • An internal error occurred in the Places SDK library.

    If you believe this error represents a bug, please file a report using the instructions on our community and support page.

    Declaration

    Swift

    case internalError = -3

    Objective-C

    kGMSPlacesInternalError = -3

  • Operation failed due to an invalid (malformed or missing) API key.

    See the developer’s guide for information on creating and using an API key.

    Declaration

    Swift

    case keyInvalid = -4

    Objective-C

    kGMSPlacesKeyInvalid = -4

  • Operation failed due to an expired API key.

    See the developer’s guide for information on creating and using an API key.

    Declaration

    Swift

    case keyExpired = -5

    Objective-C

    kGMSPlacesKeyExpired = -5

  • Operation failed due to exceeding the quota usage limit.

    See the usage limits guide for information on usage limits and how to request a higher limit.

    Declaration

    Swift

    case usageLimitExceeded = -6

    Objective-C

    kGMSPlacesUsageLimitExceeded = -6

  • Operation failed due to exceeding the usage rate limit for the API key.

    This status code shouldn’t be returned during normal usage of the API. It relates to usage of the API that far exceeds normal request levels. See the usage limits guide for more information.

    Declaration

    Swift

    case rateLimitExceeded = -7

    Objective-C

    kGMSPlacesRateLimitExceeded = -7

  • Operation failed due to exceeding the per-device usage rate limit.

    This status code shouldn’t be returned during normal usage of the API. It relates to usage of the API that far exceeds normal request levels. See the usage limits guide for more information.

    Declaration

    Swift

    case deviceRateLimitExceeded = -8

    Objective-C

    kGMSPlacesDeviceRateLimitExceeded = -8

  • The Places API service for iOS is not enabled.

    See the developer’s guide to learn how to set up the Places SDK for iOS or the migration guide if you are migrating from an earlier version.

    Declaration

    Swift

    case accessNotConfigured = -9

    Objective-C

    kGMSPlacesAccessNotConfigured = -9

  • The application’s bundle identifier does not match one of the allowed iOS applications for the API key.

    See the developer’s guide for how to configure bundle restrictions on API keys.

    Declaration

    Swift

    case incorrectBundleIdentifier = -10

    Objective-C

    kGMSPlacesIncorrectBundleIdentifier = -10

  • The Places SDK could not find the user’s location. This may be because the user has not allowed the application to access location information.

    Declaration

    Swift

    case locationError = -11

    Objective-C

    kGMSPlacesLocationError = -11

  • The Places SDK could not process the invalid request.

    If you believe this error represents a bug, please file a report using the instructions on our community and support page.

    Declaration

    Swift

    case invalidRequest = -12

    Objective-C

    kGMSPlacesInvalidRequest = -12