- HTTP isteği
- İstek metni
- Yanıt metni
- LocationBias
- LocationRestriction
- Öneri
- PlacePrediction
- FormattableText
- StringRange
- StructuredFormat
- QueryPrediction
Belirli bir giriş için 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "input": string, "locationBias": { object ( |
Alanlar | |
---|---|
input |
Zorunlu. Arama yapılacak metin dizesi. |
locationBias |
İsteğe bağlı. Belirli bir yerle ilgili önyargı sonuçları. En fazla |
locationRestriction |
İsteğe bağlı. Sonuçları belirli bir konumla sınırlandır. En fazla |
includedPrimaryTypes[] |
İsteğe bağlı. https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki birincil yer türü (örneğin, "restoran" veya "gas_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. Hiçbir tür belirtilmezse tüm Yer türleri döndürülür. |
includedRegionCodes[] |
İsteğe bağlı. Yalnızca belirtilen bölgelerdeki sonuçları dahil edin (en fazla 15 CLDR iki karakterli bölge koduyla belirtilir). Boş bir 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 değerine ayarlanır. |
regionCode |
İsteğe bağlı. CLDR iki karakterli bölge kodu olarak belirtilen bölge kodu. Bu, adres biçimlendirmesini ve 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ı. Hedefe olan jeodezik mesafenin hesaplanacağı başlangıç noktası ( |
inputOffset |
İsteğe bağlı. İmleç konumunu Boş bırakılırsa 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 INVALID_ARGUMENT 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ı veya Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla sorgu ve 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ın her oturum için yeni bir jeton oluşturması gerekir. 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 öneriler listesi içerir. |
LocationBias
Aranacak bölge. Sonuçlar, belirtilen bölge çevresinde sapma gösterebilir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Bir kuzeydoğu ve güneybatı köşesiyle tanımlanan görüntü alanı. |
circle |
Bir merkez noktası ve yarıçapla tanımlanan bir daire. |
LocationRestriction
Aranacak bölge. Sonuçlar, belirtilen bölgeyle kısıtlanır.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Bir kuzeydoğu ve güneybatı köşesiyle tanımlanan görüntü alanı. |
circle |
Bir merkez noktası ve yarıçapla tanımlanan bir daire. |
Öneri
Otomatik tamamlama öneri sonucu.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
placePrediction |
Bir yer için tahmin. |
queryPrediction |
Bir sorgu için tahmin. |
PlacePrediction
Otomatik Yer 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ı için bu genellikle işletme adı ve adresidir.
Bu metin, places.get tarafından döndürülen
|
structuredFormat |
Yer tahmininin, Yerin adını içeren ana metin ve belirsizleştirilmiş ek özellikler (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.
|
types[] |
https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A veya Tablo B'den bu Yer için geçerli olan türlerin listesi. Tür, Yer için yapılan bir kategorilendirmedir. Ortak türlere sahip yerler de benzer özelliklere sahiptir. |
distanceMeters |
|
FormattableText
Bir yer veya sorgu tahminini temsil eden metin. Metin, olduğu gibi veya biçimlendirilmiş olarak 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 metin içindeki bir alt dizeyi tanımlar.
JSON gösterimi |
---|
{ "startOffset": integer, "endOffset": integer } |
Alanlar | |
---|---|
startOffset |
Dizenin ilk Unicode karakterinin (dahil) sıfır tabanlı ofseti. |
endOffset |
Son Unicode karakterinin sıfır tabanlı ofseti (hariç). |
StructuredFormat
Bir yer veya sorgu tahmininin ana ve ikincil metne dökümünü içerir.
Yer tahminleri için, ana metin Yerin adını içerir. Sorgu tahminleri için ana metin sorguyu içerir.
İkincil metin, Yeri daha iyi tanımlamak veya sorguyu ayrıntılandı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 ayrıntılandırmak için açıklayıcı 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ılabilen bir metin sorgusunu temsil etmektedir.
|
structuredFormat |
Sorgu tahmininin, sorguyu içeren ana metin ve kesinleştirici ek özellikler (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.
|