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:
- Estás creando una app nativa para Android. En su lugar, usa el SDK de Places para Android.
- Estás creando una página web en el navegador. En su lugar, usa la API de Maps JavaScript.
- Necesitas datos de lugares de un servidor o backend a través de HTTP, en lugar de un cliente de iOS. En su lugar, usa la API de Places (nueva).
SDK de Places para iOS: Configuración
- Servicio que se habilitará:
places.googleapis.com - Autenticación: Clave de API
- Atribución de uso: Llama al método de clase
addInternalUsageAttributionIDenGMSPlacesClient(Objective-C/Swift) oPlacesClient(GooglePlacesSwift) para agregar un ID de atribución de uso. Si borras la llamada, se inhabilita la función. - Comienza: Configura el SDK de Places para iOS
- Referencia: Referencia del SDK de Places para iOS
- Precios: Uso y facturación del SDK de Places para iOS
- Políticas: Políticas del SDK de Places para iOS
- Notas de la versión: Notas de la versión del SDK de Places para iOS
Paquetes oficiales del SDK de Places para iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
SDK de Places para iOS: Productos relacionados
- Se suele usar con: SDK de Maps para iOS
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,GMSAutocompleteFetcheryGMSAutocompleteViewController) 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. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCorneryGMSAutocompleteFetcherinitWithBounds:filter: Se retiraron el 13 de octubre de 2020. Reemplazo:GMSAutocompleteFilter(locationBiasolocationRestriction) enGMSAutocompleteRequestconGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, o los modificadoresGooglePlacesSwiftplaceAutocompleteobasicPlaceAutocompletepara un widget de IU. Síntoma: Los métodos no existen en el SDK 4.0.0 y versiones posteriores (yGMSAutocompleteResultsViewControlleryGMSAutocompleteFetcherse quitaron en el SDK 11.0.0). Consulta la guía de migración.- Límites de autocompletado basados en
GMSCoordinateBounds(parámetrosGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModedefindAutocompletePredictionsFromQueryyautocompleteQuery): Retirados desde el 13 de octubre de 2020. Reemplazo:GMSAutocompleteRequestporGMSAutocompleteFilter(locationBiasolocationRestriction) yGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, o los modificadoresGooglePlacesSwiftplaceAutocompleteobasicPlaceAutocompletepara un widget de IU. Síntoma: Las propiedades y los parámetros no existen en el SDK 4.0.0 ni en versiones posteriores (yGMSAutocompleteViewControlleryfindAutocompletePredictionsFromQueryse 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:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) oPlacesClient.isPlaceOpen(with:)enGooglePlacesSwift. Síntoma: La propiedad no existe en el SDK 4.0.0 ni en versiones posteriores. Consulta la guía de migración.GMSPlaceFieldcomoNS_ENUM: Se retiró de servicio el 13 de octubre de 2020. Reemplazo: ConstantesGMSPlacePropertycon clases de solicitud, comoGMSFetchPlaceRequestyGMSPlaceSearchByTextRequest, oPlacePropertyenGooglePlacesSwift. Síntoma: Se reemplazó porNS_OPTIONSen el SDK 4.0.0 (GMSPlaceField, ya queNS_OPTIONSpertenece 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
- Devuelve un resumen potenciado por IA de las opiniones de los usuarios para un identificador de lugar de Google especificado.
- Devuelve un resumen de un lugar potenciado por IA del área y las comodidades que rodean un identificador de lugar de Google especificado para una estación de carga de vehículos eléctricos.
SDK de Places para iOS: Places
- Devuelve una lista de lugares y Place Details según una cadena de consulta.
- Devuelve una lista de lugares y Place Details cercanos a una ubicación específica.
- Devuelve resultados de autocompletado sobre lugares en función de una cadena de consulta.
- Devuelve información detallada sobre un lugar específico.
- Devolver fotos de un lugar específico Nota: Muestra las atribuciones del autor de cada foto (el nombre del autor, vinculado al URI de su perfil) junto con la foto. Las políticas de Places para cada plataforma lo requieren, por ejemplo, /maps/documentation/javascript/policies#photo-attributions y /maps/documentation/places/web-service/policies#photos-and-review.
- Cambiar el tamaño de las fotos de un lugar
- Devolver calificaciones y opiniones de un lugar específico Nota: En el servicio web de la API de Places (nueva), Place Details es una solicitud GET HTTP a https://places.googleapis.com/v1/places/{placeId} con X-Goog-FieldMask (por ejemplo, rating,userRatingCount,reviews); Text Search, Nearby Search y Autocomplete usan POST. En Android, pasa Place.Field.RATING, USER_RATING_COUNT y REVIEWS a PlacesClient.fetchPlace(). En iOS, pasa GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal y GMSPlacePropertyReviews en GMSFetchPlaceRequest.
- Agrega un widget de Autocomplete a una página web o app que devuelva resultados sobre lugares según una cadena de consulta.
- Especificar los campos de datos que se incluyen en las respuestas de información de lugares
- Especifica los tipos de lugares que se incluirán en las respuestas de información de lugares.
- Devolver información sobre el lugar en el que se encuentra actualmente el dispositivo del usuario Nota: Los métodos heredados de Current Place se quitaron en la versión 6.0 y posteriores del SDK de Places para Android, y en la versión 11.0 y posteriores del SDK de Places para iOS. Recupera las coordenadas del dispositivo de los servicios de ubicación de la plataforma y llama a Nearby Search.
- Devuelve un resumen de la Visión general creada por IA para un lugar específico.
- Devuelve un resumen del área potenciado por IA que describe los lugares que se encuentran alrededor de un lugar específico.
- Devuelve información sobre los lugares que se encuentran a lo largo de una ruta predefinida en función de una cadena de consulta.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar para buscar lugares con Text Search a partir de un conjunto de coordenadas de latitud y longitud.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar a lugares cercanos a partir de un conjunto de coordenadas de latitud y longitud.
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