- HTTP isteği
- İstek gövdesi
- Yanıt metni
- LocationBias
- LocationRestriction
- Öneri
- PlacePrediction
- FormattableText
- StringRange
- StructuredFormat
- QueryPrediction
Verilen girişle ilgili tahminleri döndürür.
HTTP isteği
POST https://places.googleapis.com/v1/places:autocomplete
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "input": string, "locationBias": { object ( |
Alanlar | |
---|---|
input |
Zorunlu. Arama yapılacak metin dizesi. |
locationBias |
İsteğe bağlı. Belirtilen konum için yanlılık sonuçları. En fazla |
locationRestriction |
İsteğe bağlı. Sonuçları belirtilen bir konumla sınırlandırın. En fazla |
includedPrimaryTypes[] |
İsteğe bağlı. Yer Türleri'nde (https://developers.google.com/maps/documentation/places/web-service/place-types) ya da yalnızca (bölgeler) veya yalnızca (şehirler) A Tablosu veya Tablo B'deki birincil Yer türü (örneğin, "restoran" veya "gaz_station") eklendi. Bir Yer yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. Herhangi bir tür belirtilmezse tüm Yer türleri döndürülür. |
includedRegionCodes[] |
İsteğe bağlı. En fazla 15 CLDR iki karakterli bölge kodu olarak belirtilen, yalnızca belirtilen bölgelerdeki sonuçları dahil edin. Boş küme sonuçları kısıtlamaz. Hem |
languageCode |
İsteğe bağlı. Sonuçların döndürüleceği dil. Varsayılan olarak en-US kullanılır. |
regionCode |
İsteğe bağlı. İki karakterli CLDR bölge kodu olarak belirtilen bölge kodu. Bu, adres biçimlendirmesini, sonuç sıralamasını etkiler ve hangi sonuçların döndürüleceğini etkileyebilir. Bu işlem, sonuçları belirtilen bölgeyle kısıtlamaz. Sonuçları bir bölgeyle kısıtlamak için |
origin |
İsteğe bağlı. Varış noktasına jeodezik mesafenin hesaplanacağı başlangıç noktası ( |
inputOffset |
İsteğe bağlı. İmlecin Boşsa varsayılan olarak |
includeQueryPredictions |
İsteğe bağlı. Doğru ise, yanıt hem Yer hem de sorgu tahminlerini içerir. Aksi takdirde, yanıt yalnızca Yer tahminleri döndürür. |
sessionToken |
İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir GEÇERSİZ_BAĞ_DEĞ_SAY hatası döndürülür. Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve kullanıcı bir yer seçip Yer Ayrıntıları ya da Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla sorgu olabilir. Ardından bir Yer Ayrıntıları veya Adres Doğrulama isteği gelebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. Aşağıdaki yönergeleri öneririz:
|
Yanıt gövdesi
places.autocomplete için yanıt protokolü.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"suggestions": [
{
object ( |
Alanlar | |
---|---|
suggestions[] |
Alaka düzeyine göre azalan düzende sıralanmış bir öneri listesini içerir. |
LocationBias
Aranacak bölge. Sonuçlar, belirtilen bölge etrafında yanlı olabilir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan görünüm. |
circle |
Bir merkez noktası ve yarıçapla tanımlanan daire. |
LocationRestriction
Aranacak bölge. Sonuçlar, belirtilen bölgeyle sınırlandırılır.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan görünüm. |
circle |
Bir merkez noktası ve yarıçapla tanımlanan daire. |
Öneri
Otomatik tamamlama önerisi sonucu.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
placePrediction |
Bir yer için tahmin. |
queryPrediction |
Bir sorgu için tahmin. |
PlacePrediction
Yer Otomatik Tamamlama tahmini için tahmin sonuçları.
JSON gösterimi |
---|
{ "place": string, "placeId": string, "text": { object ( |
Alanlar | |
---|---|
place |
Önerilen yerin kaynak adı. Bu ad, yer adlarını kabul eden diğer API'lerde kullanılabilir. |
placeId |
Önerilen yerin benzersiz tanımlayıcısı. Bu tanımlayıcı, Yer Kimliklerini kabul eden diğer API'lerde kullanılabilir. |
text |
Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. Kuruluş sonuçlarında genellikle işletme adı ve adresi kullanılır.
Bu metin, places.get tarafından döndürülen
|
structuredFormat |
Yer tahmininin, Yerin adını ve belirsizliği önleyen ek özellikleri (şehir veya bölge gibi) içeren ikincil metne göre dökümü.
|
types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki A veya B tablosundan bu Yer için geçerli olan türlerin listesi. Tür, bir Yerin sınıflandırılmasıdır. Paylaşılan türleri olan yerler de benzer özelliklere sahiptir. |
distanceMeters |
|
FormattableText
Bir yer veya sorgu tahminini temsil eden metin. Metin olduğu veya biçimlendirildiği şekilde kullanılabilir.
JSON gösterimi |
---|
{
"text": string,
"matches": [
{
object ( |
Alanlar | |
---|---|
text |
Olduğu gibi kullanılabilecek veya |
matches[] |
Giriş isteğinin Bu değerler, |
StringRange
Belirli bir metinde bir alt dizeyi tanımlar.
JSON gösterimi |
---|
{ "startOffset": integer, "endOffset": integer } |
Alanlar | |
---|---|
startOffset |
Dizenin ilk Unicode karakterinin (dahil) sıfır tabanlı uzaklığı. |
endOffset |
Son Unicode karakterinin sıfır tabanlı uzaklığı (hariç). |
StructuredFormat
Yer veya sorgu tahmininin ana metin ve ikincil metne dökümünü içerir.
Yer tahminlerinde, ana metin Yer'in adını içerir. Sorgu tahminleri için ana metin sorguyu içerir.
İkincil metin, Yeri daha iyi tanımlamak veya sorguyu hassaslaştırmak için açıklayıcı ek özellikler (şehir veya bölge gibi) içerir.
JSON gösterimi |
---|
{ "mainText": { object ( |
Alanlar | |
---|---|
mainText |
Yerin veya sorgunun adını temsil eder. |
secondaryText |
Yeri daha iyi tanımlamak veya sorguyu hassaslaştırmak için, ayırt edici ek özellikleri (şehir veya bölge gibi) temsil eder. |
QueryPrediction
Otomatik Sorgu Tamamlama tahmini için tahmin sonuçları.
JSON gösterimi |
---|
{ "text": { object ( |
Alanlar | |
---|---|
text |
Tahmin edilen metin. Bu metin bir yeri değil, arama uç noktasında (örneğin, Metin Arama) kullanılabilecek bir metin sorgusunu temsil eder.
|
structuredFormat |
Sorgu tahmininin, sorguyu ve netleştirmeyi sağlayan ek özellikleri (ör. şehir veya bölge) içeren ikincil metne ve sorguyu içeren ana metne dökümü.
|