Siz yazarken önerilen sorguları döndürerek metin tabanlı coğrafi aramalar için sorgu tahmini sağlamak üzere Sorgu Otomatik Tamamlama (Eski) kullanılabilir.
Otomatik Sorgu Tamamlama (Eski) istekleri
Query Autocomplete (Eski), Places API'nin (Eski) bir parçasıdır ve Places API (Eski) ile API anahtarı ve kota paylaşır.
Sorgu Otomatik Tamamlama (Eski), uygulamanıza anında coğrafi sorgu tahminleri eklemenize olanak tanır. Kullanıcılar belirli bir konumu aramak yerine "New York yakınında pizza" gibi kategorik bir arama yapabilir ve hizmet, dizeyle eşleşen önerilen sorguların listesini döndürür. Sorgu Otomatik Tamamlama (Eski), hem tam kelimeler hem de alt dizelerle eşleşebildiğinden uygulamalar, kullanıcı yazarken sorgu gönderebilir ve anında tahminler sunabilir.
Bir sorgu otomatik tamamlama (eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:
https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters
Burada output, json veya xml olabilir.
Sorgu Otomatik Tamamlama (Eski) isteği başlatmak için belirli parametreler gereklidir.
URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.
Gerekli parametreler
-
giriş
Aranacak metin dizesi. Yer Adı Otomatik Tamamlama hizmeti, bu dizeye göre olası eşleşmeleri döndürür ve sonuçları algılanan alaka düzeylerine göre sıralar.
İsteğe bağlı parametreler
-
language
Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste tam olmayabilir.
-
languagesağlanmazsa API,Accept-Languageüstbilgisinde belirtilen tercih edilen dili kullanmaya çalışır. - API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki sokak adreslerini döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
- Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
- Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar. Örneğin, Macarca'da utca ve tér, sokak kelimesinin eş anlamlılarıdır.
-
konum
Aramanın yapılacağı noktayı
latitude,longitudekoordinatları olarak tanımlar. Yer hizmeti, aramayılocationveradiusile tanımlanan alandaki sonuçları gösterecek şekilde yönlendirmek için konumu kullanır. Tanımlanan alanın dışındaki sonuçlar da gösterilebilir.query,Market in Barcelonagibi açık bir konum içeriyorsalocationparametresi geçersiz kılınabilir. Sorgunun etrafında tırnak işareti kullanmak,locationveradiussembollerine verilen ağırlığı da etkileyebilir. -
telafi etmek
Hizmetin tahminleri eşleştirmek için kullandığı son karakterin giriş terimindeki konumu. Örneğin, giriş
Googleise ve ofset 3 ise hizmetGooile eşleşir. Ofset ile belirlenen dize yalnızca giriş terimindeki ilk kelimeyle eşleştirilir. Örneğin, giriş terimiGoogle abcise ve ofset 3 ise hizmet,Goo abcile eşleşmeye çalışır. Bir ofset sağlanmazsa hizmet, tüm dönemi kullanır. Kaydırma genellikle metin imlecinin konumuna ayarlanmalıdır. -
yarıçap
Yer sonuçlarının döndürüleceği mesafeyi (metre cinsinden) tanımlar.
locationveradiusparametrelerini ileterek sonuçları belirli bir çevreye göre yönlendirebilirsiniz. Bu işlemi yaptığınızda Yerler hizmetine, sonuçları bu daire içinde göstermeyi tercih etmesi talimatı verilir. Tanımlanan alanın dışındaki sonuçlar yine de gösterilebilir.Yarıçap, arama türüne ve diğer parametrelere bağlı olarak otomatik olarak maksimum değerle sınırlandırılır.
- Otomatik tamamlama: 50.000 metre
-
Yakında Arama:
keywordveyanameile: 50.000 metre-
keywordveyanameolmadan-
50.000 metreye kadar (alan yoğunluğuna göre dinamik olarak ayarlanır),
rankbyparametresinden bağımsızdır. -
rankby=distancekullanılırken yarıçap parametresi kabul edilmez veINVALID_REQUESTile sonuçlanır.
-
50.000 metreye kadar (alan yoğunluğuna göre dinamik olarak ayarlanır),
- Otomatik Sorgu Tamamlama: 50.000 metre
- Metin Arama: 50.000 metre
Otomatik Sorgu Tamamlama (Eski) örnekleri
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'Fransızca sonuçlar içeren "Par yakınındaki pizzacılar" isteği:
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &language=fr &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'Bu örneklerdeki API anahtarını kendi anahtarınızla değiştirmeniz gerektiğini unutmayın.
Otomatik Sorgu Tamamlama (Eski) yanıtı
Sorgu Otomatik Tamamlama (Eski) yanıtları, URL isteğinin yolundaki output işaretiyle belirtilen biçimde döndürülür. Aşağıdaki sonuçlar, şu parametreleri içeren bir sorgu için döndürülür:
URL
https://maps.googleapis.com/maps/api/place/queryautocomplete/json ?input=pizza%20near%20par &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'JSON
{ "predictions": [ { "description": "pizza near Paris, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Paris, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Paris" }, { "offset": 18, "value": "France" }, ], }, { "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Pari Chowk" }, { "offset": 23, "value": "NRI City" }, { "offset": 33, "value": "Omega II" }, { "offset": 43, "value": "Noida" }, { "offset": 50, "value": "Uttar Pradesh" }, { "offset": 65, "value": "India" }, ], }, { "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA", "secondary_text_matched_substrings": [{ "length": 3, "offset": 16 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Disneyland Park" }, { "offset": 28, "value": "Disneyland Drive" }, { "offset": 46, "value": "Anaheim" }, { "offset": 55, "value": "CA" }, { "offset": 59, "value": "USA" }, ], }, { "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 30 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" }, { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" }, { "offset": 83, "value": "Paris" }, { "offset": 90, "value": "France" }, ], }, { "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France", "matched_substrings": [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }], "structured_formatting": { "main_text": "pizza", "main_text_matched_substrings": [{ "length": 5, "offset": 0 }], "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France", "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }], }, "terms": [ { "offset": 0, "value": "pizza" }, { "offset": 6, "value": "near" }, { "offset": 11, "value": "Paris Beauvais Airport" }, { "offset": 35, "value": "Route de l'Aéroport" }, { "offset": 56, "value": "Tillé" }, { "offset": 63, "value": "France" }, ], }, ], "status": "OK", }
XML
<AutocompletionResponse> <status>OK</status> <prediction> <description>pizza near Paris, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Paris</value> <offset>11</offset> </term> <term> <value>France</value> <offset>18</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Paris, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Pari Chowk</value> <offset>11</offset> </term> <term> <value>NRI City</value> <offset>23</offset> </term> <term> <value>Omega II</value> <offset>33</offset> </term> <term> <value>Noida</value> <offset>43</offset> </term> <term> <value>Uttar Pradesh</value> <offset>50</offset> </term> <term> <value>India</value> <offset>65</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Disneyland Park</value> <offset>11</offset> </term> <term> <value>Disneyland Drive</value> <offset>28</offset> </term> <term> <value>Anaheim</value> <offset>46</offset> </term> <term> <value>CA</value> <offset>55</offset> </term> <term> <value>USA</value> <offset>59</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>22</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>16</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Cathédrale Notre-Dame de Paris</value> <offset>11</offset> </term> <term> <value>Parvis Notre-Dame - place Jean-Paul-II</value> <offset>43</offset> </term> <term> <value>Paris</value> <offset>83</offset> </term> <term> <value>France</value> <offset>90</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>36</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>30</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> <prediction> <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description> <term> <value>pizza</value> <offset>0</offset> </term> <term> <value>near</value> <offset>6</offset> </term> <term> <value>Paris Beauvais Airport</value> <offset>11</offset> </term> <term> <value>Route de l'Aéroport</value> <offset>35</offset> </term> <term> <value>Tillé</value> <offset>56</offset> </term> <term> <value>France</value> <offset>63</offset> </term> <matched_substring> <offset>0</offset> <length>5</length> </matched_substring> <matched_substring> <offset>11</offset> <length>3</length> </matched_substring> <structured_formatting> <description>pizza</description> <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription> <description_matched_substring> <offset>0</offset> <length>5</length> </description_matched_substring> <subdescription_matched_substring> <offset>5</offset> <length>3</length> </subdescription_matched_substring> </structured_formatting> </prediction> </AutocompletionResponse>
Yer hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (ör. location uzaktaysa) boş bir predictions dizisi döndürür. XML yanıtları sıfır veya daha fazla <prediction> öğesinden oluşur.
PlacesQueryAutocompleteResponse
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | Array<PlaceAutocompletePrediction> |
Tahmin dizisi içerir. Daha fazla bilgi için PlaceAutocompletePrediction bölümünü inceleyin. |
|
required | PlacesAutocompleteStatus |
İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgileri içerebilir. Daha fazla bilgi için PlacesAutocompleteStatus bölümüne bakın. |
|
isteğe bağlı | dize |
Hizmet |
|
isteğe bağlı | Array<string> |
Hizmet, istek spesifikasyonu hakkında ek bilgiler döndürdüğünde yanıt nesnesinde ek bir |
PlacesAutocompleteStatus
Hizmet tarafından döndürülen durum kodları.
OKAPI isteğinin başarılı olduğunu gösterir.-
ZERO_RESULTS, aramanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, arama uzak bir konumda sınırlarla sınırlandırılmışsa meydana gelebilir. -
API isteğinin hatalı biçimlendirildiğini gösterir.
Bu durum genellikle
inputparametresinin eksik olmasından kaynaklanır.INVALID_REQUEST -
OVER_QUERY_LIMITaşağıdakilerden herhangi birini gösteriyorsa:- Saniyede sorgu sınırlarını aştınız.
- Hesabınızda faturalandırma etkinleştirilmemiştir.
- Aylık 200 ABD doları kredi veya kendinizin belirlediği kullanım sınırı aşılmıştır.
- Belirtilen ödeme yöntemi artık geçerli değil (örneğin, kredi kartının süresi dolmuş).
-
İsteğinizin reddedildiğini belirten
REQUEST_DENIEDe-postası gönderilir. Bunun nedeni genellikle:- İstek API anahtarı içermiyor.
keyparametresi geçersiz.
UNKNOWN_ERRORbilinmeyen bir hatayı gösterir.
Yer hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (ör. location uzaksa) boş bir predictions dizisi döndürür. XML yanıtları sıfır veya daha fazla <prediction> öğesinden oluşur.
PlaceAutocompletePrediction
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | dize |
Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Girilen terimin tahmin sonucu metnindeki konumunu açıklayan alt dizeler listesi. Böylece, istenirse terim vurgulanabilir. Daha fazla bilgi için PlaceAutocompleteMatchedSubstring bölümüne bakın. |
|
required | PlaceAutocompleteStructuredFormat |
Otomatik tamamlama sonuçlarınızda gösterilebilecek önceden biçimlendirilmiş metinler sağlar. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır. Daha fazla bilgi için PlaceAutocompleteStructuredFormat bölümüne bakın. |
|
required | Array<PlaceAutocompleteTerm> |
Döndürülen açıklamanın her bölümünü tanımlayan bir terim dizisi içerir (açıklamanın bir bölümü genellikle virgülle sonlandırılır). Dizideki her girişte, terimin metnini içeren bir Daha fazla bilgi için PlaceAutocompleteTerm bölümünü inceleyin. |
|
isteğe bağlı | tam sayı |
Başlangıç noktasından metre cinsinden düz çizgi mesafesi. Bu alan yalnızca |
|
isteğe bağlı | dize |
Bir yeri benzersiz şekilde tanımlayan metin biçiminde bir tanımlayıcı. Yerle ilgili bilgileri almak için bu tanımlayıcıyı Places API isteğinin placeId alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliklerine genel bakış bölümünü inceleyin. |
|
isteğe bağlı | dize |
place_id'yi inceleyin. |
|
isteğe bağlı | Array<string> |
Bu yer için geçerli olan çeşitli türleri içerir. Örneğin:
|
PlaceAutocompleteMatchedSubstring
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | sayı |
Tahmin sonucu metninde eşleşen alt dizenin uzunluğu. |
|
required | sayı |
Tahmin sonucu metninde eşleşen alt dizenin başlangıç konumu. |
PlaceAutocompleteStructuredFormat
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | dize |
Genellikle yerin adı olan bir tahminin ana metnini içerir. |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Daha fazla bilgi için PlaceAutocompleteMatchedSubstring bölümüne bakın. |
|
isteğe bağlı | dize |
Genellikle yerin konumunu içeren bir tahminin ikincil metnini içerir. |
|
isteğe bağlı | Array<PlaceAutocompleteMatchedSubstring> |
Daha fazla bilgi için PlaceAutocompleteMatchedSubstring bölümüne bakın. |
PlaceAutocompleteTerm
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | sayı |
Açıklamada bu terimin başlangıç konumunu Unicode karakterleriyle ölçülmüş olarak tanımlar. |
|
required | dize |
Terimin metni. |