Referencia rápida del SDK de Places para iOS

El SDK de Places para iOS permite que las apps para iOS obtengan información sobre lugares (empresas, lugares de interés y ubicaciones geográficas) a través de Place Details, Place Photos, Text Search, Nearby Search y Autocomplete. La API de Places (nueva) es la versión actual del SDK.

SDK de Places para iOS: Datos clave

  • Producto: SDK de Places para iOS
  • También conocido como: SDK de Places para iOS (nuevo)
  • Categoría: Lugares
  • Plataforma: iOS
  • Se ejecuta en: El cliente (código de la app o del navegador)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Activo
  • Descripción general: Descripción general del SDK de Places para iOS

Cuándo usar el SDK de Places para iOS

Usa el SDK de Places para iOS en los siguientes casos:

  • Necesitas resultados de Place Details, fotos, Text Search o Nearby Search dentro de una app nativa para iOS.
  • Necesitas autocompletar el nombre o la dirección de un lugar a medida que los usuarios escriben en una app para iOS.
  • Quieres componentes prediseñados del kit de IU de Places (detalles de lugares, búsqueda, autocompletado) en una app para iOS.

No uses el SDK de Places para iOS en los siguientes casos:

SDK de Places para iOS: Configuración

Paquetes oficiales del SDK de Places para iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

SDK de Places para iOS: Errores comunes

  • Problema: Las llamadas al SDK de Places para iOS (nuevo) fallan si la API de Places (nueva) no está habilitada en el proyecto de Cloud o no se encuentra en la lista de APIs autorizadas de la clave de API. Solución: Habilita la API de Places (nueva) y agrégala a las restricciones de la clave de API que usa la app. Consulta /maps/documentation/places/ios-sdk/legacy/migrate-overview.
  • Problema: kGMSPlacesRateLimitExceeded (-7) significa que la clave de API superó su límite de frecuencia de uso. Las apps que se ejecutan en versiones desactivadas del SDK 2.x (desactivadas el 29 de julio de 2019) también reciben este error. Solución: Verifica la cuota y el uso de la API de Places (nueva) en la consola de Google Cloud y actualiza las apps que tengan versiones del SDK anteriores a la 3.0. Consulta /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode.
  • Problema: Los tokens de sesión que se reutilizan en apps del mismo proyecto o en diferentes sesiones interrumpen la agrupación de facturación de sesiones de autocompletado. Solución: Genera un token de sesión único (se recomienda el UUID versión 4) por sesión de Autocomplete. Los tokens deben ser únicos por proyecto. Consulta /maps/documentation/places/ios-sdk/use-session-tokens.
  • Problema: Las apps muestran datos de lugares sin las atribuciones que devuelve la API. Solución: Muestra todas las atribuciones pertinentes que se devuelven con los datos de Places, según la página de políticas. Consulta /maps/documentation/places/ios-sdk/overview.

SDK de Places para iOS: Funciones heredadas y obsoletas

  • SDK de Places para iOS (versión heredada): Heredado desde el 1 de marzo de 2025. Reemplazo: SDK de Places para iOS (nuevo) (requiere la API de Places (nueva)). Síntoma: Las clases y los métodos heredados (por ejemplo, fetchPlaceFromPlaceID, GMSAutocompleteFetcher y GMSAutocompleteViewController) no existen en el SDK 11.0.0 ni en versiones posteriores, lo que interrumpe la compilación. Consulta la guía de migración.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner y GMSAutocompleteFetcher initWithBounds:filter: Se retiraron el 13 de octubre de 2020. Reemplazo: GMSAutocompleteFilter (locationBias o locationRestriction) en GMSAutocompleteRequest con GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, o los modificadores GooglePlacesSwift placeAutocomplete o basicPlaceAutocomplete para un widget de IU. Síntoma: Los métodos no existen en el SDK 4.0.0 y versiones posteriores (y GMSAutocompleteResultsViewController y GMSAutocompleteFetcher se quitaron en el SDK 11.0.0). Consulta la guía de migración.
  • Límites de autocompletado basados en GMSCoordinateBounds (parámetros GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode de findAutocompletePredictionsFromQuery y autocompleteQuery): Retirados desde el 13 de octubre de 2020. Reemplazo: GMSAutocompleteRequest por GMSAutocompleteFilter (locationBias o locationRestriction) y GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, o los modificadores GooglePlacesSwift placeAutocomplete o basicPlaceAutocomplete para un widget de IU. Síntoma: Las propiedades y los parámetros no existen en el SDK 4.0.0 ni en versiones posteriores (y GMSAutocompleteViewController y findAutocompletePredictionsFromQuery se quitaron en el SDK 11.0.0). Consulta la guía de migración.
  • GMSPlace.openNowStatus: Retirado desde el 13 de octubre de 2020. Reemplazo: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) o PlacesClient.isPlaceOpen(with:) en GooglePlacesSwift. Síntoma: La propiedad no existe en el SDK 4.0.0 ni en versiones posteriores. Consulta la guía de migración.
  • GMSPlaceField como NS_ENUM: Se retiró de servicio el 13 de octubre de 2020. Reemplazo: Constantes GMSPlaceProperty con clases de solicitud, como GMSFetchPlaceRequest y GMSPlaceSearchByTextRequest, o PlaceProperty en GooglePlacesSwift. Síntoma: Se reemplazó por NS_OPTIONS en el SDK 4.0.0 (GMSPlaceField, ya que NS_OPTIONS pertenece a la API heredada y no existe en el SDK 11.0.0 ni en versiones posteriores). Consulta la guía de migración.
  • Versión 2.7.0 del SDK de Places para iOS: Retirada desde el 29 de julio de 2019. Reemplazo: Versión actual del SDK de Places para iOS. Síntoma: Errores kGMSPlacesRateLimitExceeded.

Qué puedes hacer con el SDK de Places para iOS

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.

SDK de Places para iOS: IA generativa

SDK de Places para iOS: Places

SDK de Places para iOS: kit de IU de Places

  • Aplicar diseño de CSS a un elemento de la IU de datos de lugar Nota: Las propiedades personalizadas de CSS se aplican a los elementos del kit de IU de Places de la API de Maps JavaScript. El SDK de Places para Android y el SDK de Places para iOS aplican diseño a las vistas del kit de IU de Places de forma programática con atributos de tema y estilo. REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
  • Personaliza el diseño y la configuración de los elementos de la IU de datos de lugares con una herramienta de personalización de elementos de la IU. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
  • Agrega un elemento de la IU que muestre información sobre un lugar específico en una página web o app para dispositivos móviles. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
  • Agrega a una página web un elemento de la IU que muestre una lista de lugares según una cadena de consulta. Nota: Se admite tanto en páginas web (API de Maps JavaScript) como en apps para dispositivos móviles (SDK de Places para Android y SDK de Places para iOS). REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
  • Agrega un elemento de la IU que muestre una lista de lugares cercanos a una ubicación específica en una página web. Nota: Se admite tanto en páginas web (API de Maps JavaScript) como en apps para dispositivos móviles (SDK de Places para Android y SDK de Places para iOS). REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
  • Agrega un elemento básico de la IU de Autocomplete a una página web o app que devuelva identificadores de Google Places según una cadena de consulta. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq