El SDK de Places para iOS proporciona a tu app información enriquecida sobre los lugares, incluidos el nombre y la dirección del lugar, la ubicación geográfica especificada como coordenadas de latitud y longitud, el tipo de lugar (como un club nocturno, una tienda de mascotas y un museo), entre otros. Para acceder a esta información de un lugar específico, puedes usar el ID de lugar, un identificador estable que identifica un lugar de forma exclusiva.
Detalles del lugar
La clase GMSPlace
proporciona información sobre un lugar específico. Puedes obtener un objeto GMSPlace
de las siguientes maneras:
- Llama al método
GMSPlacesClient findPlaceLikelihoodsFromUserLocationWithPlaceFields:
. Consulta la guía para obtener el lugar actual. - Llama a
GMSPlacesClient fetchPlaceFromPlaceID:
pasando un objetoGMSPlaceField
, un ID de lugar y un método de devolución de llamada. En el caso de las solicitudes de Place Details, si no especificas, al menos, un campo con una solicitud, o si omites el parámetrofields
en una solicitud, se mostrarán TODOS los campos posibles y se te facturará en consecuencia. Consulta la guía para obtener un lugar por ID.
Cuando solicitas un lugar, debes especificar qué tipos de datos de lugar se mostrarán. Para ello, pasa un GMSPlaceField
y especifica los tipos de datos que se mostrarán. Esta es una consideración importante, ya que afectará el costo de cada solicitud.
Debido a que los resultados de datos de lugares no pueden estar vacíos, solo se muestran resultados de lugares con datos (por ejemplo, si un lugar solicitado no tiene fotos, el campo photos
no estará presente en el resultado).
En el siguiente ejemplo, se pasa una lista de dos valores de campo para especificar los datos que muestra una solicitud:
Swift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) | UInt(GMSPlaceField.placeID.rawValue))!
Objective‑C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return. GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);
Obtén más información sobre los campos de lugares. Si deseas consultar más detalles sobre cómo se facturan las solicitudes de datos de Places, consulta Uso y facturación.
La clase GMSPlace
puede contener los siguientes datos de lugar:
name
: el nombre del lugar.placeID
: el identificador textual del lugar. Obtén más información sobre los IDs de lugar en el resto de esta página.coordinate
: la ubicación geográfica del lugar, especificada como coordenadas de latitud y longitud.phoneNumber
: Es el número de teléfono del lugar, en formato internacional.formattedAddress
: la dirección legible de esta ubicación.A menudo, esta dirección equivale a la "dirección postal". Ten en cuenta que, en algunos países, como los que integran el Reino Unido, no se permite la distribución de direcciones postales verdaderas debido a restricciones de licencia.
La dirección con formato está compuesta, de manera lógica, por uno o más componentes de dirección. Por ejemplo, la dirección "111 8th Avenue, New York, NY" consta de los siguientes componentes: "111" (número de la calle), "8th Avenue" (calle), "New York" (ciudad) y "NY" (estado de los EE.UU.).
No analices la dirección con formato de forma programática. En cambio, utiliza los componentes individuales de la dirección, que la respuesta de la API incluye además del campo de dirección con formato.
openingHours
: Indica el horario de atención del lugar (como lo representaGMSOpeningHours
). Llama alGMSOpeningHours.weekdayText
para obtener una lista de strings localizadas del horario de atención diario de la semana. Llama aGMSOpeningHours.Periods
para mostrar una lista deGMSPeriod
con información más detallada equivalente a los datos proporcionados porweekdayText
. Nota: Si un lugar siempre está abierto, el período se representa como domingo a la medianoche y el valor decloseEvent
es nulo.addressComponents
: Es un array de objetosGMSAddressComponent
que representa componentes de la dirección de un lugar. Se proporcionan estos componentes con el fin de extraer información estructurada sobre la dirección de un lugar, por ejemplo, encontrar la ciudad en la que se encuentra un lugar. No uses estos componentes para dar formato a las direcciones. En su lugar, usa la propiedadformattedAddress
, que proporciona una dirección con formato localizada.Ten en cuenta los siguientes datos sobre el arreglo
addressComponents
:- El array de componentes de dirección puede contener más componentes que
formattedAddress
. - El array no necesariamente incluye todas las entidades políticas que contienen una dirección, además de las incluidas en
formattedAddress
. - No se garantiza que el formato de la respuesta permanezca igual entre solicitudes. En particular, la cantidad de
addressComponents
varía según la dirección solicitada y puede cambiar con el tiempo para la misma dirección. Un componente puede cambiar de posición en el array. El tipo de componente puede cambiar. Es posible que falte un componente en particular en una respuesta posterior.
- El array de componentes de dirección puede contener más componentes que
userRatingsTotal
: Representa la cantidad de opiniones que conforman la calificación del lugar.
La clase GMSPlace
contiene las siguientes funciones de miembro:
-
isOpen
calcula si un lugar está abierto en un momento determinado, segúnopeningHours
yUTCOffsetMinutes
, y la fecha y hora actuales. isOpenAtDate
calcula si un lugar está abierto en una fecha determinada, segúnopeningHours
yUTCOffsetMinutes
, y la fecha y hora actuales.
Cuando se usan estas funciones para obtener los horarios de apertura o las fechas, la solicitud original fetchPlaceFromPlaceID:
o findPlaceLikelihoodsFromUserLocationWithPlaceFields:
debe especificar los campos GMSPlaceFieldOpeningHours
y GMSPlaceFieldUTCOffsetMinutes
. Si falta alguno de estos campos, el objeto GMSPlace
resultante no incluirá fechas ni horarios de apertura, y la llamada mostrará GMSPlaceOpenStatusUnknown
. Para garantizar resultados precisos, solicita los campos GMSPlaceFieldBusinessStatus
y GMSPlaceFieldUTCOffsetMinutes
en la solicitud de lugar original. Si no se solicita, se supone que la empresa está operativa.
isOpen
con Place Details.
Obtener un sitio por id.
Un ID de lugar es un identificador textual que identifica de forma exclusiva un lugar. En el SDK de Places para iOS, puedes recuperar el ID de un lugar desde un objeto GMSPlace
. Puedes almacenar el ID de lugar y usarlo para recuperar el objeto GMSPlace
más tarde.
Para obtener un lugar por ID, llama a GMSPlacesClient
fetchPlaceFromPlaceID:
y pasa los siguientes parámetros:
- Una string que contiene un ID de lugar.
- Uno o más
GMSPlaceField
, que especifican los tipos de datos que se mostrarán - Un token de sesión si la llamada se realiza para concluir una consulta de autocompletado. De lo contrario, pasa “nil”.
- Un
GMSPlaceResultCallback
para controlar el resultado
La API invoca el método de devolución de llamada especificado y pasa un objeto GMSPlace
. Si no se encuentra el sitio, el objeto de sitio es nil.
Swift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Specify the place data types to return. let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) | UInt(GMSPlaceField.placeID.rawValue))! placesClient?.fetchPlace(fromPlaceID: placeID, placeFields: fields, sessionToken: nil, callback: { (place: GMSPlace?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let place = place { self.lblName?.text = place.name print("The selected place is: \(place.name)") } })
Objective‑C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; // Specify the place data types to return. GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID); [_placesClient fetchPlaceFromPlaceID:placeID placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } if (place != nil) { NSLog(@"The selected place is: %@", [place name]); } }];
Mostrar atribuciones en tu aplicación
Cuando tu app muestra información obtenida de GMSPlacesClient
lookUpPlaceID:callback:
, también debe mostrar atribuciones.
Consulta la documentación sobre las atribuciones.
Más información sobre los id. de sitio
El ID de lugar del SDK de Places para iOS es el mismo identificador que se usa en la API de Places, el SDK de Places para Android y otras API de Google.
Cada ID de lugar puede referirse a un solo lugar, pero un solo lugar puede tener más de un ID de lugar.
Existen circunstancias en las que un sitio puede obtener un id. de sitio nuevo. Esto, por ejemplo, puede suceder si un negocio se muda a otro lugar.
Cuando solicitas un sitio mediante la especificación de un ID de lugar, puedes estar seguro de que siempre recibirás el mismo lugar en la respuesta (si el lugar todavía existe). Sin embargo, ten en cuenta que la respuesta puede contener un ID de lugar diferente del que aparece en tu solicitud.
Para obtener más información, consulta la descripción general de los IDs de lugar.