Rehber hizmetini ve Bölgeleri aramak üzere Android için Haritalar SDK'sı ile Coğrafi Kodlama API'si ve yerler hakkında daha fazla bilgi almak. Places hizmeti ve Geocoding API, yer kimlikleri elde etmek için güçlü ve kararlı alternatiflerdir. Zaten yer kimlikleri kullanıyorsanız bu kimlikleri sınırlar için veri odaklı stil ile yeniden kullanabilirsiniz.
Android için Haritalar SDK'sına Yerler hizmetini ve Coğrafi Kodlama'yı aşağıdaki yöntemlerle ekleyin:
- Android için Yerler SDK'sı, yerlerle ilgili bilgi döndüren yöntemleri içeren bir Android kitaplığıdır.
- Places API, HTTP isteklerini kullanarak yerler hakkında bilgi döndürür.
- Coğrafi kodlayıcı sınıfı kullanıcı girişinden dinamik olarak coğrafi kodlama yapabilir ve coğrafi kodlamayı tersine çevirebilir.
- Geocoding API, bilinen statik adresleri coğrafi kodlamanıza olanak tanır.
Rehber hizmetini kullanma
Yer kimliği bulmak için metin aramayı (yeni) kullanma
Alan maskesinde places.id belirterek bölge verilerini içeren bir yer kimliği almak için Places API'deki Text Search (Yeni) REST API'sini kullanabilirsiniz.
Metin Arama (Yeni) ile yalnızca yer kimliklerini isteme
ücretsiz. Daha fazla bilgi edinin.
Örneğin, Kaliforniya, Trinidad için yer kimliğini almak üzere aşağıdaki API çağrısını yapabilirsiniz:
curl -X POST -d '{
"textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'
Bölgeleri bulmak için Yerler Otomatik Tamamlama özelliğini kullanın
Android için Places SDK'sındaki Yerler Otomatik Tamamlama hizmeti, kullanıcılarınızın bölge aramasını sağlamanın kolay bir yolunu sunar. Yerler Otomatik Tamamlama hizmetini yalnızca bölgeleri döndürecek şekilde yapılandırmak için tür filtresini PlaceTypes.REGIONS olarak ayarlamak üzere AutocompleteSupportFragment.setTypesFilter(List) simgesini kullanın.
Bir bölgenin yer ayrıntılarını alma
Android için Yerler SDK'sındaki Yer Ayrıntıları hizmeti, bir bölgeyle ilgili veriler döndürerek oldukça faydalı olabilir. Örneğin, şunları yapabilirsiniz:
- Yer adlarına göre sınır yer kimliklerini arayın.
- Bir sınırı yakınlaştırmak için görünümü alın.
- Sınırın özellik türünü alın (örneğin,
locality). - Amerika Birleşik Devletleri bölgesinde "Yer Adı, Eyalet, Ülke" olarak çözülen biçimlendirilmiş adresi alın (örneğin, "Ottumwa, IA, ABD").
- Fotoğraflar gibi başka faydalı verileri alabilirsiniz.
Coğrafi Kodlama API'sini kullanma
Coğrafi Kodlama API, bir adresi enlem ve boylam koordinatlarına ve yer kimliğine dönüştürmenize veya enlem ve boylam koordinatlarını ya da yer kimliğini bir adrese dönüştürmenize olanak tanır. Aşağıdaki kullanım alanları, sınırlar için veriye dayalı stil ile iyi bir uyum sağlar:
- Bir bölgenin görüntü alanını almak için Coğrafi Kodlama'yı kullanın.
- Coğrafi Kodlama çağrınıza bileşen filtrelemesi uygulayarak idari bölgeler, yerel birim veya posta kodu.
- Yer kimliklerini enlem ve boylama göre bulmak için tersine coğrafi kodlamayı kullanın koordinatlarını verebilir, hatta belirli bir konumdaki tüm bileşenlerin konum.
Aşağıdaki örnekte Coğrafi Kodlama API'sı:
https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY
Ters coğrafi kodlamayı kullanabilirsiniz kullanabilirsiniz. Aşağıdaki coğrafi kodlama hizmeti işlevi örneği, belirtilen enlem ve boylam koordinatlarındaki tüm adres bileşenlerinin yer kimliklerini döndürür:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY
Adres bileşenini almak için bileşen filtrelemeyle tersine coğrafi kodlama kullanma belirtilen konumda aşağıdaki türlerin biri veya daha fazlası için:
administrativeAreacountrylocalitypostalCode
Bir sonraki örnek işlev, Coğrafi Kodlama hizmetini kullanarak
tüm adres bileşenlerini aynı zamanda almak için tersine coğrafi kodlamayla
yalnızca locality türü için belirtilen konum:
https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY