Com o SDK do Places para iOS, você pode descobrir o lugar em que o dispositivo está localizado. Ou seja, o lugar no local informado atualmente do dispositivo. Exemplos de lugares incluem empresas locais, pontos de interesse e locais geográficos.
- Solicitar autorização de localização
- Limites de uso
- Acessar o local atual
- Mostrar atribuições no app
Como solicitar autorização de localização
Se o app usar
GMSPlacesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
,
ele precisará solicitar permissão para usar os serviços de localização. Adicione a chave NSLocationWhenInUseUsageDescription
ao arquivo Info.plist
para definir a string que informa ao usuário por que você precisa dos serviços de localização. Exemplo:
<key>NSLocationWhenInUseUsageDescription</key> <string>Show your location on the map</string>
Se você quiser chamar
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
quando
o app estiver em segundo plano, sem acionar uma caixa de diálogo de confirmação, siga
estas etapas antes de fazer a chamada:
- Adicione a chave
NSLocationAlwaysUsageDescription
ao arquivoInfo.plist
. - Chame
requestAlwaysAuthorization
em qualquer instância deCLLocationManager
antes de chamar o método.
Solicite autorização de CLLocationManager
da seguinte maneira:
locationManager.requestAlwaysAuthorization()
[self.locationManager requestAlwaysAuthorization];
Como acessar a localização atual
Para encontrar a empresa local ou outro lugar onde o dispositivo está
localizado, chame
GMSPlacesClient
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
. Inclua
os seguintes parâmetros:
- Um ou mais
GMSPlaceField
s, especificando quais tipos de dados retornar. Se você omitir esse parâmetro, TODOS os campos possíveis serão retornados, e uma cobrança será feita. Isso se aplica apenas a solicitações do Place Details. - Um método de callback para processar os resultados.
Os campos correspondem aos resultados da pesquisa de lugares e são divididos em três categorias de faturamento: "Basic", "Contact" e "Atmosphere". Os campos básicos são faturados na taxa básica e não geram cobranças extras. Os campos "Contact" e "Atmosphere" são faturados em uma taxa maior. Para mais informações sobre como as solicitações de dados de lugar são faturadas, consulte Uso e faturamento.
A API invoca o método de callback especificado, retornando uma matriz de
objetos
GMSPlaceLikelihood
.
Cada objeto
GMSPlaceLikelihood
representa um lugar. Para cada lugar, o resultado inclui uma indicação da probabilidade de que o lugar seja o certo. Um valor mais alto
significa uma maior probabilidade de que o lugar seja a melhor correspondência. O buffer pode
estar vazio se não houver um lugar conhecido correspondente à localização do dispositivo.
O exemplo de código abaixo recupera a lista de lugares em que o dispositivo tem mais probabilidade de estar localizado e registra o nome e a probabilidade de cada lugar.
// Specify the place data types to return. let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) | UInt(GMSPlaceField.placeID.rawValue))! placesClient?.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: fields, callback: { (placeLikelihoodList: Array<GMSPlaceLikelihood>?, error: Error?) in if let error = error { print("An error occurred: \(error.localizedDescription)") return } if let placeLikelihoodList = placeLikelihoodList { for likelihood in placeLikelihoodList { let place = likelihood.place print("Current Place name \(String(describing: place.name)) at likelihood \(likelihood.likelihood)") print("Current PlaceID \(String(describing: place.placeID))") } } })
// Specify the place data types to return. GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID); [_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:fields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) { if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } if (likelihoods != nil) { for (GMSPlaceLikelihood *likelihood in likelihoods) { GMSPlace *place = likelihood.place; NSLog(@"Current place name: %@", place.name); NSLog(@"Place ID: %@", place.placeID); } } }];
Observações sobre os valores de probabilidade:
- A probabilidade fornece uma probabilidade relativa de o lugar ser a melhor correspondência na lista de lugares retornados para uma única solicitação. Não é possível comparar as probabilidades entre diferentes solicitações.
- O valor da probabilidade estará entre 0 e 1,0.
- A soma das probabilidades em uma matriz retornada de
objetos
GMSPlaceLikelihood
é sempre menor ou igual a 1,0. A soma não é necessariamente 1,0.
Por exemplo, para representar uma probabilidade de 55% de que o lugar correto é o A, e uma probabilidade de 35% de que é o B, a matriz de probabilidade tem dois membros: o lugar A com uma probabilidade de 0,55 e o lugar B com uma probabilidade de 0,35.
Como mostrar atribuições no seu app
Quando o app mostra informações obtidas de
GMSPlacesClient
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
, ele
também precisa mostrar as atribuições. Leia mais sobre
atribuições.