Yer Adı Otomatik Tamamlama (Eski)

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Yer Adı Otomatik Tamamlama (Eski), bir HTTP isteğine yanıt olarak yer tahminleri döndüren bir web hizmetidir. İstek, metin tabanlı bir arama dizesi ve isteğe bağlı coğrafi sınırlar belirtir. Bu hizmet, kullanıcı metin girerken işletmeler, adresler ve önemli yerler gibi yerleri döndürerek metin tabanlı coğrafi aramalar için otomatik tamamlama işlevi sağlamak amacıyla kullanılabilir.

Yer Adı Otomatik Tamamlama (Eski) istekleri

Yer Adı Otomatik Tamamlama (Eski), Places API'nin bir parçasıdır ve Places API ile bir API anahtarı ve kotaları paylaşır.

Yer Adı Otomatik Tamamlama (Eski), tam kelimeler ve alt dizelerle eşleşerek yer adlarını, adresleri ve Plus Code'ları çözebilir. Bu nedenle uygulamalar, anında yer tahminleri sağlamak için kullanıcı yazarken sorgu gönderebilir.

Plus Code'ları doğru şekilde biçimlendirmeniz gerekir. Bu, artı işaretini URL çıkış karakteriyle %2B, boşlukları ise URL çıkış karakteriyle %20 olarak değiştirmeniz gerektiği anlamına gelir.

  • global code, dört karakterli bir alan kodu ve altı karakter veya daha uzun bir yerel koddur. Örneğin, URL çıkışlı global kod 849VCWC8+R9, 849VCWC8%2BR9 şeklindedir.
  • Bileşik kod, açık bir konuma sahip altı karakterli (veya daha uzun) yerel bir koddur. Örneğin, URL çıkış karakteri eklenmiş bileşik kod CWC8+R9 Mountain View, CA, USA, CWC8%2BR9%20Mountain%20View%20CA%20USA şeklindedir.

Döndürülen tahminler, kullanıcıya istediği yeri seçmesine yardımcı olmak için sunulacak şekilde tasarlanmıştır. Döndürülen yerlerden herhangi biri hakkında daha fazla bilgi edinmek için Yer Ayrıntıları (eski) isteği gönderebilirsiniz.

Yer Adı Otomatik Tamamlama (Eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/autocomplete/output?parameters

Burada output, aşağıdaki değerlerden biri olabilir:

  • json (önerilir), çıkışın JavaScript Object Notation (JSON) biçiminde olduğunu gösterir.
  • xml, çıkışın XML olarak gösterileceğini belirtir.

Yer Adı Otomatik Tamamlama (Eski) isteği başlatmak için belirli parametreler gereklidir. URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri 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 eşleşme adayları döndürür ve sonuçları algılanan alaka düzeylerine göre sıralar.

İsteğe bağlı parametreler

bileşenler

Sonuçlarınızı kısıtlamak istediğiniz yerlerin gruplandırılması. Bileşenleri kullanarak en fazla 5 ülkeye göre filtreleme yapabilirsiniz. Ülkeler, iki karakterli, ISO 3166-1 alfa-2 uyumlu bir ülke kodu olarak iletilmelidir. Örneğin: components=country:fr, sonuçlarınızı Fransa'daki yerlerle kısıtlar. Birden fazla ülke, ayırıcı olarak dikey çizgi karakteri | kullanılarak birden fazla country:XX filtresi olarak iletilmelidir. Örneğin: components=country:us|country:pr|country:vi|country:gu|country:mp sonuçlarınızı ABD ve ABD'nin birleştirilmemiş organize bölgeleriyle kısıtlar.

Not: Bir ülke koduyla beklenmedik sonuçlar alırsanız hedeflediğiniz ülkeleri, bağımlı bölgeleri ve özel coğrafi ilgi alanlarını içeren bir kod kullandığınızı doğrulayın. Kod bilgilerini Wikipedia: ISO 3166 ülke kodları listesi veya ISO Online Browsing Platform'da bulabilirsiniz.

language

Sonuçların döndürüleceği dil.

  • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
  • language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
  • API, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için tercih edilen dili dikkate alarak açık adresleri yerel dilde döndürür ve gerekirse kullanıcının okuyabileceği bir alfabeye dönüştürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen dilde döndürülür.
  • Tercih edilen dilde bir ad yoksa 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 göre 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ı kelimeler. Örneğin, Macarcada utca ve tér, sokak kelimesinin eş anlamlılarıdır.

konum

Yer bilgilerinin alınacağı nokta. Bu, latitude,longitude olarak belirtilmelidir. Konum belirtilirken radius parametresi de sağlanmalıdır. radius sağlanmazsa location parametresi yok sayılır.

Text Search API kullanılırken `query` parametresi `Barselona'daki pazar` gibi açık bir konum içeriyorsa `location` parametresi geçersiz kılınabilir.

locationbias

Bir yarıçap ve enlem/boylam ya da bir dikdörtgenin noktalarını temsil eden iki enlem/boylam çifti belirterek belirli bir alandaki sonuçları tercih edin. Bu parametre belirtilmezse API, varsayılan olarak IP adresi ağırlıklandırmasını kullanır.

  • IP bias: API'ye IP adresi yönlendirmesini kullanma talimatı verir. ipbias dizesini iletin (bu seçeneğin ek parametreleri yoktur).
  • Dairesel: Metre cinsinden yarıçapı ve ondalık derece cinsinden enlem/boylamı belirten bir dize. Şu biçimi kullanın: circle:radius@lat,lng.
  • Dikdörtgen: Bir dikdörtgenin güney/batı ve kuzey/doğu noktalarını temsil eden, ondalık derece cinsinden iki enlem/boylam çiftini belirten bir dize. Aşağıdaki biçimi kullanın:rectangle:south,west|north,east. Doğu/batı değerlerinin -180, 180 aralığına sığdırıldığını ve kuzey/güney değerlerinin -90, 90 aralığına sabitlendiğini unutmayın.

locationrestriction

Yarıçap ve enlem/boylam veya bir dikdörtgenin noktalarını temsil eden iki enlem/boylam çifti belirterek sonuçları belirli bir alanla kısıtlayın.

  • Dairesel: Metre cinsinden yarıçapı ve ondalık derece cinsinden enlem/boylamı belirten bir dize. Şu biçimi kullanın: circle:radius@lat,lng.
  • Dikdörtgen: Bir dikdörtgenin güney/batı ve kuzey/doğu noktalarını temsil eden, ondalık derece cinsinden iki enlem/boylam çiftini belirten bir dize. Aşağıdaki biçimi kullanın:rectangle:south,west|north,east. Doğu/batı değerlerinin -180, 180 aralığına sığdırıldığını ve kuzey/güney değerlerinin -90, 90 aralığına sabitlendiğini unutmayın.

telafi etmek

Hizmetin tahminleri eşleştirmek için kullandığı son karakterin giriş terimindeki konumu. Örneğin, giriş Google ve ofset 3 ise hizmet Goo ile eşleşir. Ofset tarafından belirlenen dize, yalnızca giriş terimindeki ilk kelimeyle eşleştirilir. Örneğin, giriş terimi Google abc ve ofset 3 ise hizmet, Goo abc ile eşleştirmeye çalışır. Herhangi bir fark sağlanmazsa hizmet, tüm terimi kullanır. Ofset genellikle metin imlecinin konumuna ayarlanmalıdır.

kaynak

Hedefe olan düz çizgi mesafesinin hesaplanacağı başlangıç noktası (distance_meters olarak döndürülür). Bu değer atlanırsa düz çizgi mesafesi döndürülmez. latitude,longitude olarak belirtilmelidir.

yarıçap

Yer sonuçlarının döndürüleceği mesafeyi (metre cinsinden) tanımlar. Bir location ve radius parametresi ileterek sonuçları belirli bir daireye yönlendirebilirsiniz. Bunu yaptığınızda Places hizmetine, sonuçları bu daire içinde göstermeyi tercih etmesi talimatı verilir. Tanımlanan alanın dışındaki sonuçlar da gösterilebilir.

Yarıçap, arama türüne ve diğer parametrelere bağlı olarak otomatik olarak maksimum bir değerle sınırlandırılır.

  • Otomatik tamamlama: 50.000 metre
  • Yakında Arama:
    • keyword veya name ile: 50.000 metre
    • keyword veya name olmadan
      • rankby parametresinden bağımsız olarak, alan yoğunluğuna göre dinamik olarak ayarlanan, en fazla 50.000 metre.
      • rankby=distance kullanılırken yarıçap parametresi kabul edilmez ve INVALID_REQUEST hatasıyla sonuçlanır.
  • Query Autocomplete: 50.000 metre
  • Metin Arama: 50.000 metre

bölge

İki karakterli bir ccTLD ("üst düzey alan") değeri olarak belirtilen bölge kodu. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).

sessiontoken

Faturalandırma amacıyla otomatik tamamlama oturumunu tanımlayan rastgele bir dize.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve bir yer seçip Yer Ayrıntıları'na çağrı yapıldığında sona erer. Her oturumda birden fazla sorgu ve ardından bir yer seçimi olabilir. Bir oturumdaki her istek için kullanılan API anahtarları aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdikten sonra jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessiontoken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri uygulamanızı öneririz:

  • Tüm otomatik tamamlama oturumları için oturum jetonları kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanılması önerilir.
  • Bir oturumdaki tüm Yer Adı Otomatik Tamamlama ve Yer Ayrıntıları istekleri için kullanılan API anahtarlarının aynı Cloud Console projesine ait olduğundan emin olun.
  • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturum için kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

strictbounds

Yalnızca location ve radius ile tanımlanan bölgenin içinde yer alan yerleri döndürür. Bu bir ağırlık değil, kısıtlamadır. Yani bu bölgenin dışındaki sonuçlar, kullanıcı girişiyle eşleşse bile döndürülmez.

türler

types parametresini ileterek Yer Adı Otomatik Tamamlama isteğinden gelen sonuçları belirli bir türle kısıtlayabilirsiniz. Bu parametre, Yer Türleri bölümünde listelenen bir türü veya tür koleksiyonunu belirtir. Hiçbir şey belirtilmezse tüm türler döndürülür.

Bir yer, Tablo 1 veya Tablo 2'de listelenen türlerden yalnızca tek bir birincil türe sahip olabilir. Örneğin, yemek servisi yapılan bir otel yalnızca types=lodging ile döndürülebilir, types=restaurant ile döndürülemez.

types parametresinin değeri için şunlardan birini belirtebilirsiniz:

  • Tablo 1 veya Tablo 2'den en fazla beş değer. Birden fazla değer kullanıyorsanız her değeri | (dikey çubuk) ile ayırın. Örneğin:

    types=book_store|cafe

  • Tablo 3'teki desteklenen filtrelerden herhangi biri. Tür koleksiyonlarını karıştıramazsınız.

Aşağıdaki durumlarda istek INVALID_REQUEST hatasıyla reddedilir:

  • Beşten fazla tür belirtilmiş.
  • Tanınmayan türler var.
  • Tablo 1 veya Tablo 2'deki türler, Tablo 3'teki filtrelerden herhangi biriyle karıştırılır.

Yer Adı Otomatik Tamamlama (Eski) örnekleri

San Francisco, Kaliforniya merkezli bir bölgede "Amoeba" dizesini içeren işletmeler için istek:

URL

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696
      &radius=500
      &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

Aynı istek, Ashbury St & Haight St, San Francisco'nun 500 metre yakınındaki sonuçlarla sınırlıdır:

URL

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=amoeba
      &types=establishment
      &location=37.76999%2C-122.44696&radius=500
      &strictbounds=true
      &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&strictbounds=true&key=YOUR_API_KEY'

"Vict" içeren adresler için Fransızca sonuçlar içeren bir istek:

URL

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=geocode
      &language=fr
      &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=geocode&language=fr&key=YOUR_API_KEY'

Brezilya Portekizcesi dilinde sonuçlar içeren, "Vict" ifadesini içeren şehirler için bir istek:

URL

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Vict
      &types=(cities)
      &language=pt_BR&key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Vict&types=(cities)&language=pt_BR&key=YOUR_API_KEY'

Bu örneklerdeki API anahtarını kendi anahtarınızla değiştirmeniz gerektiğini unutmayın.

Yer Adı Otomatik Tamamlama (eski) yanıtı

Yer Adı Otomatik Tamamlama (Eski) yanıtları, isteğin URL yolundaki output işaretiyle belirtilen biçimde döndürülür. Aşağıdaki sonuçlar, aşağıdaki parametreleri içeren bir sorgu için döndürülebilecek sonuçları gösterir:

URL

https://maps.googleapis.com/maps/api/place/autocomplete/json
      ?input=Paris
      &types=geocode
      &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=Paris&types=geocode&key=YOUR_API_KEY'

JSON

{
  "predictions":
    [
      {
        "description": "Paris, France",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "reference": "ChIJD7fiBh9u5kcRYJSMaMOCCwQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "France",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "France" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TX, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "reference": "ChIJmysnFgZYSoYRSfPTL2YJuck",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TX, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TX" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, TN, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "reference": "ChIJ4zHP-Sije4gRBDEsVxunOWg",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "TN, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "TN" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
      {
        "description": "Paris, Brant, ON, Canada",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "reference": "ChIJsamfQbVtLIgR-X18G75Hyi0",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "Brant, ON, Canada",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "Brant" },
            { "offset": 14, "value": "ON" },
            { "offset": 18, "value": "Canada" },
          ],
        "types": ["neighborhood", "political", "geocode"],
      },
      {
        "description": "Paris, KY, USA",
        "matched_substrings": [{ "length": 5, "offset": 0 }],
        "place_id": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "reference": "ChIJsU7_xMfKQ4gReI89RJn0-RQ",
        "structured_formatting":
          {
            "main_text": "Paris",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "KY, USA",
          },
        "terms":
          [
            { "offset": 0, "value": "Paris" },
            { "offset": 7, "value": "KY" },
            { "offset": 11, "value": "USA" },
          ],
        "types": ["locality", "political", "geocode"],
      },
    ],
  "status": "OK",
}

XML

    
<?xml version="1.0" encoding="UTF-8"?>
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>Paris, France</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>France</value>
   <offset>7</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJD7fiBh9u5kcRYJSMaMOCCwQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TX, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJmysnFgZYSoYRSfPTL2YJuck</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TX</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJmysnFgZYSoYRSfPTL2YJuck</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TX, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, TN, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJ4zHP-Sije4gRBDEsVxunOWg</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>TN</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJ4zHP-Sije4gRBDEsVxunOWg</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>TN, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, Brant, ON, Canada</description>
  <type>neighborhood</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsamfQbVtLIgR-X18G75Hyi0</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>Brant</value>
   <offset>7</offset>
  </term>
  <term>
   <value>ON</value>
   <offset>14</offset>
  </term>
  <term>
   <value>Canada</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsamfQbVtLIgR-X18G75Hyi0</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>Brant, ON, Canada</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>Paris, KY, USA</description>
  <type>locality</type>
  <type>political</type>
  <type>geocode</type>
  <reference>ChIJsU7_xMfKQ4gReI89RJn0-RQ</reference>
  <term>
   <value>Paris</value>
   <offset>0</offset>
  </term>
  <term>
   <value>KY</value>
   <offset>7</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>11</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <place_id>ChIJsU7_xMfKQ4gReI89RJn0-RQ</place_id>
  <structured_formatting>
   <description>Paris</description>
   <subdescription>KY, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

PlacesAutocompleteResponse

Alan Zorunlu Tür Açıklama
required Array<PlaceAutocompletePrediction>

Bir tahmin dizisi içerir.

Daha fazla bilgi için PlaceAutocompletePrediction sayfasına bakın.

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 bilgilerini içerebilir.

Daha fazla bilgi için PlacesAutocompleteStatus sayfasına bakın.

isteğe bağlı dize

Hizmet, OK< dışında bir durum kodu döndürdüğünde yanıt nesnesinde ek bir error_message alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgi içerir. Bu alan her zaman döndürülmez ve içeriği değişebilir.

isteğe bağlı Dizi<string>

Hizmet, istek spesifikasyonu hakkında ek bilgi döndürdüğünde yanıt nesnesinde ek bir info_messages alanı olabilir. Bu alan yalnızca başarılı istekler için döndürülür. Her zaman döndürülmeyebilir ve içeriği değişebilir.

Sonuçlar arasında özellikle place_id öğeleri ilgi çekicidir. Bu öğeler, ayrı bir sorgu kullanarak yer hakkında daha ayrıntılı bilgi istemek için kullanılabilir. Yer Ayrıntıları (Eski) istekleri bölümüne bakın.

XML yanıtı, iki tür alt öğe içeren tek bir <AutocompletionResponse> öğesinden oluşur:

  • Tek bir <status> öğesi, istekle ilgili meta verileri içerir. Aşağıdaki Durum Kodları bölümüne bakın.
  • Her biri tek bir yer hakkında bilgi içeren sıfır veya daha fazla <prediction> öğesi. Bu sonuçlar hakkında bilgi için Yer Adı Otomatik Tamamlama (Eski) Sonuçları bölümüne bakın. Places API en fazla 5 sonuç döndürür.

Uygulamanız herhangi bir nedenle xml gerektirmediği sürece tercih edilen çıkış işareti olarak json kullanmanızı öneririz. XML ağaçlarını işlerken doğru düğümlere ve öğelere referans vermek için dikkatli olmanız gerekir. XML'i işleme konusunda yardım için XPath ile XML işleme başlıklı makaleyi inceleyin.

PlacesAutocompleteStatus

Hizmet tarafından döndürülen durum kodları.

  • API isteğinin başarılı olduğunu gösteren OK.
  • ZERO_RESULTS, aramanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, arama uzak bir konumdaki bir sınıra iletildiğinde ortaya çıkabilir.
  • API isteğinin hatalı biçimlendirildiğini gösteren INVALID_REQUEST. Bu durum genellikle input parametresinin eksik olmasından kaynaklanır.
  • OVER_QUERY_LIMIT Aşağıdakilerden herhangi birini gösteren:
    • QPS sınırlarını aştınız.
    • Hesabınızda faturalandırma etkinleştirilmemiştir.
    • Aylık 200 ABD doları tutarındaki kredi veya kendi belirlediğiniz kullanım sınırı aşılmıştır.
    • Sağlanan ödeme yöntemi artık geçerli değilse (örneğin, kredi kartının süresi dolmuşsa)
    Bu hatanın nasıl çözüleceği hakkında daha fazla bilgi için Haritalar SSS sayfasını inceleyin.
  • REQUEST_DENIED genellikle şu nedenlerle isteğinizin reddedildiğini belirtir:
    • İstekte API anahtarı eksik.
    • key parametresi geçersiz.
  • Bilinmeyen bir hatayı gösteren UNKNOWN_ERROR.

Places hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları bir 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ı tarafından okunabilen adını içerir. establishment sonuçları için bu genellikle işletme adıdır. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.

required Array<PlaceAutocompleteMatchedSubstring>

Girilen terimin tahmin sonucu metnindeki konumunu açıklayan alt dizelerin listesi. Bu sayede, seçilen terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

required PlaceAutocompleteStructuredFormat

Otomatik tamamlama sonuçlarınızda gösterilebilecek önceden biçimlendirilmiş metin sağlar. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.

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ş, terimin metnini içeren bir value alanına ve bu terimin açıklamadaki başlangıç konumunu tanımlayan bir offset alanına sahiptir. Bu alan, Unicode karakterlerle ölçülür.

Daha fazla bilgi için PlaceAutocompleteTerm sayfasına bakın.

isteğe bağlı tam sayı

Başlangıç noktasından metre cinsinden düz çizgi mesafesi. Bu alan yalnızca origin ile yapılan istekler için döndürülür.

isteğe bağlı dize

Bir yeri benzersiz şekilde tanımlayan metin tanımlayıcı. Yerle ilgili bilgileri almak için bu tanımlayıcıyı bir Places API isteğinin placeId alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için Yer Kimlikleri genel bakış sayfasını inceleyin.

isteğe bağlı dize

place_id bölümüne bakın.
isteğe bağlı Dizi<string>

Bu yer için geçerli olan türlerin bir dizisini içerir. Örneğin: [ "political", "locality" ] veya [ "establishment", "geocode", "beauty_salon" ]. Dizi, birden fazla değer içerebilir. Yer türleri hakkında daha fazla bilgi edinin.

PlaceAutocompleteMatchedSubstring

Alan Zorunlu Tür Açıklama
required sayı

Tahmin sonucu metnindeki 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

main_text

required dize

Tahminin ana metnini (genellikle yerin adını) içerir.

main_text_matched_substrings

required Array<PlaceAutocompleteMatchedSubstring>

offset değeri ve length içeren bir dizi içerir. Bunlar, girilen terimin tahmin sonucu metnindeki konumunu açıklar. Böylece, seçilirse terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

secondary_text

isteğe bağlı dize

Bir tahminin ikincil metnini (genellikle yerin konumu) içerir.

secondary_text_matched_substrings

isteğe bağlı Array<PlaceAutocompleteMatchedSubstring>

offset değeri ve length içeren bir dizi içerir. Bunlar, girilen terimin tahmin sonucu metnindeki konumunu açıklar. Böylece, seçilirse terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

PlaceAutocompleteTerm

Alan Zorunlu Tür Açıklama
required sayı

Bu terimin açıklamadaki başlangıç konumunu tanımlar (Unicode karakterlerle ölçülür)

required dize

Terimin metni.

Yer Adı Otomatik Tamamlama (Eski) optimizasyonu

Bu bölümde, Yer Adı Otomatik Tamamlama (Eski) hizmetinden en iyi şekilde yararlanmanıza yardımcı olacak en iyi uygulamalar açıklanmaktadır.

Genel kurallardan bazıları şunlardır:

Maliyet optimizasyonuyla ilgili en iyi uygulamalar

Temel maliyet optimizasyonu

Yer Adı Otomatik Tamamlama (Eski) hizmetini kullanma maliyetini optimize etmek için Yer Ayrıntıları (Eski) ve Yer Adı Otomatik Tamamlama (Eski) widget'larında alan maskeleri kullanarak yalnızca ihtiyacınız olan Yer Adı Otomatik Tamamlama (Eski) veri alanlarını döndürün.

Gelişmiş maliyet optimizasyonu

SKU: Otomatik Tamamlama - İstek Başına fiyatlandırmaya erişmek ve Yer Ayrıntıları (Eski) yerine seçilen yerle ilgili Geocoding API sonuçlarını istemek için Yer Adı Otomatik Tamamlama'nın (Eski) programatik uygulamasını kullanabilirsiniz. Geocoding API ile eşlenen istek başına fiyatlandırma, aşağıdaki koşulların her ikisi de karşılandığında oturum başına (oturum tabanlı) fiyatlandırmadan daha uygun maliyetlidir:

  • Yalnızca kullanıcının seçtiği yerin enlem ve boylamına veya adresine ihtiyacınız varsa Geocoding API, bu bilgileri Place Details (Legacy) çağrısından daha düşük bir ücret karşılığında sağlar.
  • Kullanıcılar ortalama dört veya daha az Yer Adı Otomatik Tamamlama (Eski) tahmini isteği içinde bir otomatik tamamlama tahmini seçerse istek başına fiyatlandırma, oturum başına fiyatlandırmadan daha uygun maliyetli olabilir.
Uygulamanız için en düşük maliyetli Yer Adı Otomatik Tamamlama (Eski) uygulamasını seçmek üzere aşağıdaki tabloda uygulamanızın ihtiyaçlarına uygun satırı bulun.
Uygulamanızın ihtiyaç duyduğu izinler Kullanıcı bir tahmin seçmeden önceki ortalama Yer Adı Otomatik Tamamlama (Eski) isteği sayısı Önerilen uygulama
Adres ve konum dışındaki yer ayrıntıları (ör. yer adı, işletme durumu veya çalışma saatleri) Herhangi bir sayıda Yer Ayrıntıları (Eski) ile oturum tabanlı Yer Adı Otomatik Tamamlama (Eski)
Yalnızca seçilen tahminin adresi ve enlem/boylamı Dört veya daha az Geocoding API ile istek başına Yer Adı Otomatik Tamamlama (Eski)
Yalnızca seçilen tahminin adresi ve enlem/boylamı Dörtten fazla Yalnızca adres uygulamaları için oturum tabanlı Yer Adı Otomatik Tamamlama (Eski)

Geocoding API, Place Autocomplete (Eski) kullanımınızın performansına bağlı olarak uygulamanız için Place Details'ten (Eski) daha uygun maliyetli bir seçenek olabilir. Her uygulamanın Yer Adı Otomatik Tamamlama (Eski) verimliliği; kullanıcıların ne girdiğine, uygulamanın nerede kullanıldığına ve performans optimizasyonuyla ilgili en iyi uygulamaların hayata geçirilip geçirilmediğine bağlı olarak değişir.

Tablo için ortalama istek sayısını bulmak üzere, bir kullanıcının uygulamanızda bir Yer Adı Otomatik Tamamlama (Eski) tahminini seçmeden önce ortalama kaç karakter yazdığını analiz edin.

Yer Ayrıntıları (Eski) ile oturuma dayalı Yer Adı Otomatik Tamamlama (Eski)

Oturum tabanlı Yer Adı Otomatik Tamamlama (Eski) özelliğini Yer Ayrıntıları (Eski) ile kullanın.
Uygulamanız yer adı, işletme durumu veya çalışma saatleri gibi Yer Ayrıntıları (Eski) bilgilerini gerektirdiğinden, Yer Adı Otomatik Tamamlama (Eski) uygulamanızda oturum başına bir oturum jetonu (programatik olarak veya JavaScript, Android ya da iOS widget'larına yerleşik olarak) ve istediğiniz yer verisi alanlarına bağlı olarak geçerli Yerler Verisi SKU'ları kullanılmalıdır.1

Widget uygulaması
Oturum yönetimi; JavaScript, Android veya iOS widget'larına otomatik olarak yerleştirilir. Buna hem Yer Adı Otomatik Tamamlama (Eski) istekleri hem de seçilen tahmindeki Yer Ayrıntıları (Eski) isteği dahildir. Yalnızca ihtiyacınız olan Yer Adı Otomatik Tamamlama (Eski) veri alanlarını istediğinizden emin olmak için fields parametresini belirttiğinizden emin olun.

Programatik uygulama
Yer Adı Otomatik Tamamlama (Eski) isteklerinizde oturum jetonu kullanın. Seçilen tahminle ilgili Yer Ayrıntıları (Eski) isteğinde bulunurken aşağıdaki parametreleri ekleyin:

  1. Yer Adı Otomatik Tamamlama (Eski) yanıtındaki yer kimliği
  2. Yer Adı Otomatik Tamamlama (Eski) isteğinde kullanılan oturum jetonu
  3. İhtiyacınız olan Yer Adı Otomatik Tamamlama (Eski) veri alanlarını belirten fields parametresi

Geocoding API ile istek başına Yer Adı Otomatik Tamamlama (Eski)

Yer Adı Otomatik Tamamlama (Eski) özelliğini oturum jetonları olmadan programatik olarak uygulayın ve seçilen yer tahmini için Geocoding API'yi çağırın.
Geocoding API, adresleri ve enlem/boylam koordinatlarını sağlar. Dört adet Autocomplete - Per Request isteği ve seçilen yer tahminiyle ilgili bir Geocoding API çağrısı yapmanın maliyeti, oturum başına Yer Adı Otomatik Tamamlama (Eski) maliyetinden daha düşüktür.1

Kullanıcılarınızın aradıkları tahmini daha az karakterle almalarına yardımcı olmak için performansla ilgili en iyi uygulamalardan yararlanabilirsiniz.

Yalnızca adres içeren uygulamalar için oturuma dayalı Yer Adı Otomatik Tamamlama (Eski)

Oturum tabanlı Yer Adı Otomatik Tamamlama (Eski) özelliğini Yer Ayrıntıları (Eski) ile kullanın.
Kullanıcı bir Yer Adı Otomatik Tamamlama (Eski) tahminini seçmeden önce yapmayı beklediğiniz ortalama istek sayısı, oturum başına fiyatlandırma maliyetini aştığından Yer Adı Otomatik Tamamlama (Eski) uygulamanız hem Yer Adı Otomatik Tamamlama (Eski) istekleri hem de ilişkili Yer Ayrıntıları (Eski) isteği için bir oturum jetonu kullanmalıdır. oturum başına. 1

Widget uygulaması
Oturum yönetimi; JavaScript, Android veya iOS widget'larına otomatik olarak yerleştirilir. Buna, seçilen tahmindeki hem Yer Adı Otomatik Tamamlama (Eski) istekleri hem de Yer Ayrıntıları (Eski) isteği dahildir. Yalnızca ihtiyacınız olan alanları istediğinizden emin olmak için fields parametresini belirttiğinizden emin olun.

Programatik uygulama
Yer Adı Otomatik Tamamlama (Eski) isteklerinizde oturum jetonu kullanın. Seçilen tahminle ilgili Yer Ayrıntıları (Eski) isteğinde bulunurken aşağıdaki parametreleri ekleyin:

  1. Yer Adı Otomatik Tamamlama (Eski) yanıtındaki yer kimliği
  2. Yer Adı Otomatik Tamamlama (Eski) isteğinde kullanılan oturum jetonu
  3. Adres ve geometri gibi Temel Veri alanlarını belirten fields parametresi

Yer Adı Otomatik Tamamlama (Eski) isteklerini geciktirmeyi düşünün
Uygulamanızın daha az istek göndermesi için Yer Adı Otomatik Tamamlama (Eski) isteğini kullanıcı ilk üç veya dört karakteri yazana kadar geciktirme gibi stratejiler kullanabilirsiniz. Örneğin, kullanıcı üçüncü karakteri yazdıktan sonra her karakter için Yer Adı Otomatik Tamamlama (Eski) istekleri gönderdiğinizi varsayalım. Kullanıcı yedi karakter yazıp bir tahmin seçerse ve siz de bu tahmin için bir Geocoding API isteği gönderirseniz toplam maliyet, 4 Yer Adı Otomatik Tamamlama (Eski) İstek Başına + Coğrafi Kodlama maliyetine eşit olur.1

İstekleri geciktirmek ortalama programatik istek sayınızı dörtten az yapabiliyorsa Geocoding API ile yüksek performanslı Yer Adı Otomatik Tamamlama (Eski) uygulamasıyla ilgili kılavuzu takip edebilirsiniz. İsteklerin geciktirilmesinin, her yeni tuş vuruşunda tahminleri görmeyi bekleyen kullanıcı tarafından gecikme olarak algılanabileceğini unutmayın.

Kullanıcılarınızın aradıkları tahmini daha az karakterle bulmalarına yardımcı olmak için performansla ilgili en iyi uygulamalardan yararlanabilirsiniz.

  1. Maliyetler için Google Haritalar Platformu fiyat listelerine bakın.

Performansla ilgili en iyi uygulamalar

Aşağıdaki yönergelerde, Yer Adı Otomatik Tamamlama (Eski) performansını optimize etme yöntemleri açıklanmaktadır:

  • Place Autocomplete (Legacy) uygulamanıza ülke kısıtlamaları, konum ağırlığı ve (programatik uygulamalar için) dil tercihi ekleyin. Widget'lar, dil tercihlerini kullanıcının tarayıcısından veya mobil cihazından aldığı için widget'larda dil tercihine gerek yoktur.
  • Yer Adı Otomatik Tamamlama (Eski) özelliğine bir harita eşlik ediyorsa konumu harita görüntü alanına göre yönlendirebilirsiniz.
  • Kullanıcı, Yer Adı Otomatik Tamamlama (eski) tahminlerinden birini seçmediğinde (genellikle bu tahminlerden hiçbiri istenen sonuç adresi olmadığı için) daha alakalı sonuçlar elde etmek amacıyla orijinal kullanıcı girişini yeniden kullanabilirsiniz:
    • Kullanıcının yalnızca adres bilgisi girmesini bekliyorsanız Geocoding API çağrısında orijinal kullanıcı girişini yeniden kullanın.
    • Kullanıcının belirli bir yer için ad veya adresle sorgu girmesini bekliyorsanız Yer Ayrıntıları (Eski) isteği kullanın. Sonuçların yalnızca belirli bir bölgede gösterilmesi bekleniyorsa konum ağırlığı kullanın.
    Geocoding API'ye başvurmanın en iyi seçenek olduğu diğer senaryolar şunlardır:
    • Kullanıcılar, bir binadaki belirli birimlerin veya dairelerin adresleri gibi alt tesis adreslerini giriyor. Örneğin, Çekçe "Stroupežnického 3191/17, Praha" adresi, Yer Adı Otomatik Tamamlama (Eski) hizmetinde kısmi bir tahmin döndürür.
    • Kullanıcılar, New York'ta "23-30 29th St, Queens" veya Hawaii'nin Kauai adasında "47-380 Kamehameha Hwy, Kaneohe" gibi yol segmenti ön ekleri içeren adresler giriyor.

Konuma göre yönlendirme

location parametresi ve radius parametresi ileterek sonuçları belirli bir alana göre önceliklendirin. Bu, Yer Adı Otomatik Tamamlama'ya (Eski) tanımlanan alan içindeki sonuçları göstermeyi tercih etmesini söyler. Tanımlanan alanın dışındaki sonuçlar gösterilmeye devam edebilir. Sonuçları yalnızca belirtilen bir ülkedeki yerleri gösterecek şekilde filtrelemek için includedRegionCodes parametresini kullanabilirsiniz.

Konum kısıtlama

locationRestriction parametresini ileterek sonuçları belirli bir alanla kısıtlayın.

Ayrıca, strictbounds parametresini ekleyerek sonuçları location ve radius parametresiyle tanımlanan bölgeyle kısıtlayabilirsiniz. Bu, Yer Adı Otomatik Tamamlama'ya (Eski) yalnızca bu bölgedeki sonuçları döndürmesi talimatını verir.