Varış noktası arama

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

Destination, kullanıcının ulaşmak veya gitmek istediği belirli bir konumu ya da yeri ifade eder. Destination, konum veya yerle ilgili navigasyon noktaları, önemli yerler, girişler ve bina ana hatları gibi bilgileri de içerir.

Geocoding API'nin SearchDestinations yöntemi, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli varış noktaları hakkında ayrıntılı bilgi almanızı sağlar.

Varış noktası arama isteği

Varış noktası arama isteği, şu biçimdeki bir URL'ye gönderilen HTTP POST isteğidir:

https://geocode.googleapis.com/v4/geocode/destinations

POST isteğinin bir parçası olarak JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri iletin. Örneğin:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Varış noktası aramak için konumu 3 şekilde belirtebilirsiniz:

  • Adres
  • Yer kimliği
  • Enlem ve boylam koordinatları

Adrese göre varış noktası arama

Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını veya bir adresi temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizeleri kullanan istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:

Sorgu türü Örnek
Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. "37.422131,-122.084801"
Tek bir sorguda birden fazla yer, yol veya şehir adı gibi çok fazla kavram ya da kısıtlama "Market Street San Francisco San Jose Airport"
Google Haritalar'da gösterilmeyen posta adresi öğeleri "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
İşletme, zincir veya kategorilerin, bu varlıkların bulunmadığı konumlarla birleştirilmiş adları "Dallas, Teksas yakınlarındaki Tesco"
Birden fazla yorumu olan belirsiz sorgular "Şarj cihazı bırakma"
Artık kullanılmayan eski adlar "Middlesex Birleşik Krallık"
Coğrafi olmayan öğeler veya niyet "Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya özel adlar "The Jenga"
"The Helter Skelter"
Büyük siyasi varlıklar (şehirler, eyaletler, ülkeler) "New York City"
"California"
"USA"
Belirli adresleri olmayan rotalar "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

veya postalAddress olarak:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

postalAddress biçimini genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken kullanırsınız.

Yer kimliğine göre hedef arama

Yer kimliği sağlayarak bir hedefi alabilirsiniz:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Desteklenen yer kimlikleri

Search Destinations yöntemi, belirli ve gidilebilir varış noktalarını temsil eden yer kimlikleriyle en iyi şekilde çalışır. establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir. Ayrı konumları temsil etmeyen yer kimlikleri (ör. adres aralıklarından çıkarılanlar ["10-20 Main St" gibi]), belirli bir numarası olmayan rota bölümleri veya Plus Kodlar desteklenmez. Çok geniş bir alanı kapsayan sonuçların (ör. "Pasifik Okyanusu") yer kimlikleri de desteklenmez.

Search Destinations ile Autocomplete (New) özelliğini kullanma

Uyumluluğu sağlamak için Autocomplete (New) özelliğini kullanarak Search Destinations ile kullanılacak yer kimliklerini bulun. Autocomplete (New) özelliğini kullanırken sonuçları türe göre filtrelemek için includedPrimaryTypes parametresini kullanmanız gerekir. Aşağıdaki önerilen filtre kullanılarak Autocomplete (New) tarafından döndürülen yer kimlikleri, Search Destinations tarafından desteklenir:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Ayrıca, Autocomplete (New) isteğinizde include_pure_service_area_businesses işaretini true olarak ayarlamamanız gerekir.

Konuma göre varış noktası arama

Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

İstekte bulunmak için OAuth'u kullanma

Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. Geocoding API ile OAuth kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations yöntemiyle kullanılmak üzere aşağıdaki kapsamları destekler:

  • https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API yöntemleriyle kullanın.

Ayrıca, tüm Geocoding API yöntemleri için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, tüm yöntemlere erişim sağlayan genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.

Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.

Arama hedefleri yanıtı

Search Destinations yanıtı, konumla ilgili zengin ve yakın çevreye özel bağlam sağlar.

Search Destinations yanıtındaki PlaceView nesneleri (ör. primary, containingPlaces içindeki öğeler ve landmarks), yer türünü belirtmek için alanları kullanır:

  • types: Yerin türlerini belirten dize dizisi.
  • primaryType: Yerin birincil türünü gösteren dize.

Hem types hem de primaryType için olası dize değerleri, Yer Türleri (Yeni) sayfasındaki Tablo A ve Tablo B'den alınır.

Bu bölümde, önemli yanıt alanları açıklanmaktadır. Tüm yanıt alanlarıyla ilgili ayrıntılı bilgi için API Referansı'na bakın.

primary

İstekteki sorgu tarafından tanımlanan ana yer.

addressComponents

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Her adres bileşeni genellikle aşağıdaki alanları içerir:

  • types[], adres bileşeninin türünü belirten bir dizidir. Desteklenen türlerin listesine bakın.
  • longText, Geocoder tarafından döndürülen adres bileşeninin tam metin açıklaması veya adıdır.
  • shortText, varsa adres bileşeninin kısaltılmış metin adıdır. Örneğin, Alaska eyaleti için bir adres bileşeninin longText değeri "Alaska" ve shortText değeri, iki harfli posta kısaltması kullanılarak "AK" olabilir.
  • languageCode, bu bileşeni biçimlendirmek için kullanılan dildir (CLDR gösteriminde).

containingPlaces

Birincil hedefin parçası olduğu daha büyük varlıklar (ör. bir mağazanın bulunduğu alışveriş merkezi).

subDestinations

Birincil hedefteki daha spesifik konumlar (ör. bir binadaki daireler).

entrances

entrances[] dizisindeki nesneler aşağıdaki alanlara sahiptir:

  • displayName

    Varsa girişin kullanıcılar tarafından okunabileceği adını (ör. "South Bernardo Avenue" veya "5th Avenue") içeren bir LocalizedText nesnesi.

  • location

    Bir yere giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.

  • entrance_tags[]

    Girişin özelliklerini açıklayan giriş etiketleri dizisi. Aşağıdaki değer desteklenir:

    • "PREFERRED"

    Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir giriş bu etikete sahip değilse giriş fiziksel olarak aynı binada yer alıyor ancak yere erişim sağlamıyor demektir.

    Örneğin, döndürülen yer bir alışveriş merkezindeki restoransa "PREFERRED" girişleri restoranın kendi girişleri olur. Döndürülen diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

    Döndürülen yer bir binaysa "PREFERRED" girişleri, binanın "ana" bölümüne açılan girişler olur. Örneğin, bir alışveriş merkezinde "PREFERRED" girişleri, ana fuaye alanına erişim sağlayan girişler olacaktır. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa "PREFERRED" girişi olmayacaktır.

  • streetViewThumbnail ve streetViewAnnotation

    Street View Static API için parametreler, bu konumlarla ilgili görüntüleri göstermenize olanak tanır. Bu alanlar hakkında daha fazla bilgi edinin.

structureType

Bu yerin temsil ettiği yapı türü.

  • POINT

    Nokta konum.

  • SECTION

    Bir binanın alt bölümü.

  • BUILDING

    Bina

  • GROUNDS

    Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.

Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için yararlı olan noktaların listesini içerir. Özellikle, bir yol ağında bir yerden veya bir yere rota oluştururken başlangıç ya da bitiş noktası olarak kullanılmalıdır.

Her navigasyon noktası aşağıdaki değerleri içerir:

  • navigationPointToken, navigationPoints alanındaki bağlam bilgilerini içeren bir jetondur. Uygulamanızdaki rota ve nehir deneyimini iyileştirmek için bu jetonu rota ve navigasyon API'lerine gönderebilirsiniz. Daha fazla bilgi için Navigasyon noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.
  • location, navigasyon noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakındır ve bir yere gidip gelmek için ideal bir durma veya başlangıç noktasını temsil eder. Nokta, yerin bulunduğu yolun tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.
  • travelModes, navigasyon noktasına erişilebilen seyahat modlarının listesidir:
    • "DRIVE", arabayla yol tarifine karşılık gelen seyahat modudur.
    • "WALK", yaya yol tarifine karşılık gelen seyahat modudur.
  • usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanım türleri şunlar olabilir:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Teslim alma ve bırakma işlemleri için seyahat modunun DRIVE, kullanımın ise PICKUP veya DROPOFF olduğu navigasyon noktasını kullanın. Teslim alma veya bırakma noktaları yoksa en üstteki sürüş navigasyon noktasını kullanın.

  • altitude_meters, WGS-84 elipsoidine göre navigasyon noktasının metre cinsinden yüksekliğini içerir. Dikey olarak üst üste binen yol segmentlerinin olduğu durumlarda, sisteminizin gitmesi gereken en iyi yol segmentini seçmek için altitude_meters alanını kullanın.

landmarks

Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak önemli yakındaki yerler.

Her bir önemli nokta aşağıdaki alanları içerir:

  • place, bu önemli yeri temsil eden PlaceView nesnesidir.
  • relationalDescription, varış noktasının önemli yerle nasıl ilişkili olduğunu açıklayan, kullanıcılar tarafından okunabilir bir açıklamadır (ör. "Empire State Binası'nın yakınında" veya "Beyaz Saray'ın karşısında").
  • tags[], önemli noktanın hedef bağlamında nasıl kullanılabileceğini açıklayan bir etiket dizisidir:
    • "ADDRESS": Hedefin yaklaşık konumunu belirlemek için kullanılabilecek, yerel olarak öne çıkan bir yer.
    • "ARRIVAL": Hedefe ulaşmaya yardımcı olmak için kullanılabilecek bir yer. Hedefe yaklaşıldığında navigasyon için kullanışlıdır.
  • straightLineDistanceMeters, bu önemli noktadan hedefe olan düz çizgi mesafesini metre cinsinden gösterir.
  • travelDistanceMeters, bu önemli noktadan hedefe olan yürüme mesafesini metre cinsinden gösterir.

arrivalSummary

Varış konusunda yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetleri inceleyin.

parkingOptions

Ayrıntılı otopark bilgileri.

Yanıt biçimi

SearchDestinations, aşağıdaki JSON formunun SearchDestinationsResponse değerini döndürür:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "displayName": {
            "text": "South Bernardo Avenue",
            "languageCode": "en"
          },
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Gerekli parametreler

  • API isteğinde, varış noktası aramak için adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri bulunmalıdır:
    • addressQuery: Aranacak adres.
    • place: Aranacak yerin yer kimliği.
    • locationQuery: Aranacak konumun enlem ve boylam koordinatları.

  • FieldMask

    Bir yanıt alanı maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP üst bilgisini kullanarak yanıt alanı maskesini yönteme iletin. Örneğin, aşağıdaki istek yalnızca birincil varış noktasının girişlerini, navigasyon noktalarını ve yer kimliğini döndürür.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem bir hata döndürür. Tüm alanları döndürmek için alan maskesini * olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme bölümünü inceleyin.

İsteğe bağlı parametreler

  • travelModes

    Hangi navigationPoints türlerinin döndürüleceğini belirtir. Diğer seyahat modları için navigasyon noktaları filtrelenir. travelModes ayarlanmazsa tüm seyahat modlarının navigasyon noktaları döndürülebilir.

  • languageCode

    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.
    • languageCode sağlanmazsa API, varsayılan olarak konumun yerel dilini ve alfabesini kullanır. Geçersiz bir dil kodu belirtirseniz API, INVALID_ARGUMENT hatası döndürü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 açık adresleri yerel dilde döndürür ve gerekirse tercih edilen dili dikkate alarak kullanıcı tarafından okunabilir 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 buna dahildir.

  • regionCode

    İki karakterli CLDR kodu değeri olarak bölge kodu. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.

    Bir adresi coğrafi olarak kodlarken (ileri coğrafi kodlama) bu parametre, hizmetten gelen sonuçları belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlamaz. Bir konumun veya yerin coğrafi kodlaması, tersine coğrafi kodlama ya da yer coğrafi kodlaması yapılırken bu parametre, adresi biçimlendirmek için kullanılabilir. Bu parametre, geçerli yasaya göre sonuçları her durumda etkileyebilir.

  • placeFilter

    Bir locationQuery aramasının sonuçlarını, yalnızca bina olan varış noktalarını veya yalnızca açık adresleri olan varış noktalarını döndürmek gibi gereksinimlerinizi karşılayacak şekilde filtrelemenize olanak tanır.

    Yapısal ayrıntı düzeyine göre filtreleme

    structureType filtresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:

    • Binaları izole etme: Haritada bina ana hatlarını göstermek veya belirli bir yapıyla ilgili ayrıntıları almak için "structureType": "BUILDING" kullanın.
    • Kompleksleri anlama: Birincil sonucun tüm tesis olmasını sağlamak için "structureType": "GROUNDS" kullanın. Bu, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanları sorgularken kullanışlıdır.
    • Birimlere/bölümlere odaklanma: Bir binadaki bölümleri tanımlamak için "structureType": "SECTION" kullanın.

    Adreslerin faydalı olmasını sağlama

    Bazı yerlerin açık adresleri yoktur. addressability filtresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:

    • Net bir birincil adres zorunlu kılın: Ana varış noktası sonucunun her zaman sokak düzeyinde bir adresi veya adı olmasını sağlamak için "addressability": "PRIMARY" kullanın. Bu, net bir adresin çok önemli olduğu navigasyon veya görüntüleme amaçları için kullanışlıdır.
    • Alt Hedeflerdeki Adreslere İzin Ver: Birincil yerin adresi olmayabileceği ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabileceği durumlarda "addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresi olmasını sağlar.
    • Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse "addressability": "ANY" kullanın. Yalnızca bina ana hatları ve navigasyon noktaları gibi geometrik özelliklere ihtiyacınız olduğunda bu seçeneği kullanmanız önemle tavsiye edilir. Bu seçenek, sonuçların doğruluğunu artırır.
    Örnek: Adreslenebilir binalar için filtreleme 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations

  • efor

    Deneysel: effort parametresi deneyseldir. /v4alpha/ kanalını kullanarak HTTP istekleri oluşturun. Lansman aşamasındaki kanallar hakkında daha fazla bilgi

    Hedef sorguyu çözerken uygulanacak işleme miktarını Effort belirtir (temel olarak addressQuery çözünürlüğünü etkiler):

    • EFFORT_UNSPECIFIED: Varsayılan değer. LOW çaba ile aynı şekilde davranır.
    • LOW: En hızlı yanıt süreleri için optimizasyon yapar. Zor adresler için kapsamlı arama veya anlam belirsizliğini giderme işlemi yapmaz.
    • MEDIUM: Hız ve doğruluk arasında denge kurar. Çoğu istek, standart düşük gecikmeyle döndürülür. Belirsiz veya zor adresler için hizmet, doğruluğu artırmak amacıyla ek işlemler uygular. Bu işlemler birkaç saniye sürebilir. Kullanıcıların kısa bir duraklamayı tolere edebileceği etkileşimli iş akışları için önerilir.
    • HIGH: Eksik, resmi olmayan veya karmaşık adresler için adres çözümleme doğruluğunu en üst düzeye çıkarır. Yanıt süreleri önemli ölçüde daha uzun olabilir. Arka plan, toplu işlem veya lojistik sevkiyat iş akışları için önerilir.

    Örneğin, aşağıdaki istek, bir hedef adres sorgusunu çözmek için "effort": "HIGH" kullanır:

    curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai"
  },
  "effort": "HIGH"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

    Gecikme beklentileri, sıklık sınırları ve önerilen entegrasyon kalıpları hakkında daha fazla bilgi için Daha yüksek doğrulukla coğrafi kodlama başlıklı makaleyi inceleyin.